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Introduction 


This reference describes the objects and commands in the Adobe® Photoshop® CS2 VBScript dictionary. A 
companion document, Photoshop CS2 Scripting Guide, describes basic scripting concepts and the 
Photoshop object model. This document provides reference details of the Photoshop object model, and 
additional information on VBScript-specific features. 


This book contains the following sections: 


e This introduction, which describes scripting support in Adobe Photoshop CS2, and lists changes to the 
VBScript interface since the previous release. 


e VBScript Interface, which describes the objects of the VBScript type library for Adobe Photoshop CS2. 


e Scripting Constants, which describes the enumerated values defined for use with Adobe Photoshop 
CS2 VBScript properties and methods. 


The following changes have been made to the VBScript object model and language support in Adobe 
Photoshop CS2: 


e The emphasis has shifted from Visual Basic to VBScript with this version of Adobe Photoshop CS2. 
e The following classes have been added to the VBScripting interface: 


e CameraRawOpenOpt ions, which you use to specify options when opening a document in Camera 
Raw format. 


e ExportOpt ionsSaveForWeb, which you use to optimize documents for the Web. 

e ContactSheetOptions, which you use to create and format contact sheets. 

e BatchOptions, which you use to specify options for the Batch command. 

e LensBlurOptions, which you use to specify options when applying the Lens Blur filter to a layer. 


e Notifier and Notifiers, which you use to associate a script with an event so that the script 
executes when the event occurs. For example, you can create a Notifier object to associate a 
script with the Photoshop CS2 application opening; whenever the application opens, the script 
runs. 


VBScript Interface 


The objects of the VBScript type library for Adobe Photoshop CS2 are presented alphabetically and in 
tabular format in this chapter. 


Object properties and methods are described in separate tables for each object. See ‘Working with the 
Properties Tables’ on page 6 and ‘Working with the Methods Tables’ on page 6 for information on how to 
use these tables. 


Sample code for several object model classes is given to help illustrate the syntax as well as usage of the 
object class. 


The Properties table for an object lists the following: 
e The properties you can use with the object 
e The value type for each property 


When the value type is a constant or another object, the value is a hypertext link to the constant’s or 
object's listing, as in the following Properties table sample. 


e The property's input status: Read-only or Read-write. 
e Adescription that explains what the property is 


Descriptions are omitted for self-explanatory properties. 


Property Value Type What it is 


DisplayDialogs PsDialogModes Read-write. Controls whether or not Adobe Photoshop CS2 
displays dialog boxes. 


The Methods table for an object lists the following: 
e The method name 
e Parameter(s) 


When a parameter type or return value is a constant or another object, the value is a hypertext link to 
the constant's or object’s listing. In the following Methods table sample, the parameter type 
ActionDescriptor is an object; the parameter type DialogModes is a constant; the return value 
ActionDescriptor is also an object. 


Parameters can be required or optional. Optional parameters are indicated in the table by square 
brackets ([]). See ‘Working with Method Parameters’ on page 7 for information on using parameters. 


e Return value type(s) 


e A description, if applicable 
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Method Parameter Type Returns What it does 
ExecuteAction ActionDescriptor Plays an Act ionManager event. 
(EventID Number (Long) 
[, Descriptor] act ionDescriptor 
L DisplayDialogs]) PSPtalogModes 


Optional parameters are surrounded by square brackets ([] ). In the following Methods table sample, the 
parameters Descriptor and DisplayDialogs are optional and the parameter Event ID is not. See 


Therefore, if you use the ExecuteAction() method for the object associated with the sample Methods 
table above, you must include an Event ID value in the Parentheses following the method name. The 
Event ID value must be a number, as indicated by the Number (Long) in the table’s Parameter Type 
column. 


If you use an optional parameter, you must separate the parameters with a comma, as indicated by the 
comma that precedes each optional parameter in the table. 


Also, if you use an optional parameter, you must enter the values in the order they are listed in the table so 
that the JavaScript compiler knows which value you are entering. To skip an optional parameter, insert an 
extra comma to act as a placeholder. 


The following sample provides values for an Event ID and a DisplayDialog, but skips the Descriptor 
parameter (represented by the empty value between two commas). The statement executes action #4233 


and allows only error type dialog boxes to be displayed. 


appRef .ExecuteAction (4233, ,Error) 
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Arecord of key-value pairs for actions, such as those included on the Adobe Photoshop CS2 Actions menu. 


Note: The ActionDescriptor class is part of the Action Manager functionality. See ‘Action Manager’ on 


page 145. 

Property Value Type What it is 

Application Object (Application) Read-only. The application that the collection belongs to. 

Count Number (Long) Read-only. The number of keys contained in the descriptor. 

typename String Read-only. The class name of the referenced 

ActionDescriptor object. 

Method Parameter Type Returns What it does 

Clear Clears the descriptor. 
() 

Erase Erases a key from the descriptor. 
(Key) Number (Long) 

GetBoolean Boolean Gets the value of a key of type 
(Key) Number (Long) boolean. 

GetClass Number (Long) Gets the value of a key of type 
(Key) Number (Long) class. 

GetDouble Number (Double) Gets the value of a key of type 
(Key) Number (Long) double. 

GetEnumerationType Number (Long) Gets the enumeration type of a 
(Key) Number (Long) key. 

GetEnumerationValue Number (Long) Gets the enumeration value of a 
(Key) Number (Long) key. 

GetInteger Number (Long) Gets the value of a key of type 
(Key) Number (Long) integer. 

GetKey Number (Long) Gets the ID of the Nth key. 
(Index) Number (Long) 

GetList ActionList Gets the value of a key of type list. 
(Key) Number (Long) 

GetObjectType Number (Long) Gets the class ID of an object ina 
(Key) Number (Long) key of type object. 
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Method Parameter Type Returns What it does (Continued) 

GetObjectValue ActionDescriptor Gets the value of a key of type 
(Key) Number (Long) object. 

GetPath file Gets the value of a key of type 
(Key) Number (Long) Alias. 

GetReference ActionReference Gets the value of a key of type 
(Key) Number (Long) ActionReference 

GetString String Gets the value of a key of type 
(Key) Number (Long) String. 

GetType PsDescValueType Gets the type of a key. 
(Key) Number (Long) 

GetUnitDoubleType Number (Long) Gets the unit type of a key of type 
(Key) Number (Long) UnitDouble. 

GetUnitDoubleValue Number (Double) Gets the value of a key of type 
(Key) Number (Long) UnitDouble. 

HasKey Boolean Checks whether the descriptor 
(Key) Number (Long) contains the provided key. 

IsEqual Boolean Determines whether the 
(otherDesc) aae aa descriptor is the same as another 

descriptor. 

PutBoolean Sets the value for a key whose type 
(Key, Number (Long) is Boolean. 
Value) Boolean 

PutClass Sets the value for a key whose type 
( (Key, Number (Long) is class. 
Value) Number (Long) 

PutDouble Sets the value for a key whose type 
(Key, Number (Long) is double. 
Value) Number (Double) 

PutEnumerated Sets the enumeration type and 
(Key, Number (Long) value for a key. See Chapter 4, 
EnumType Number (Long) se eripti C "i 

j Number (Long) cripting Constants”, for 

value) information on enumerated types. 

PutInteger Sets the value for a key whose type 
(Key, Number: trong) is integer. 
Value) Number (Long) 

PutList Sets the value for a key whose type 
(Key, Number (Long) isan ActionList object. 
Value) ActionList 

PutObject Sets the value for a key whose type 
(Key, Number (Long) is an Action Descriptor. 
ClassID, Number (Long) 


Value) 


ActionDescriptor 
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Method Parameter Type Returns What it does (Continued) 

PutPath Sets the value for a key whose type 
(Key, Number (Long) is path. 
Value) file 

PutReference Sets the value for a key whose type 
(Key, Number (Long) is an object reference. 
Value) ActionReference 

PutString Sets the value for a key whose type 
(Key, Number (Long) is String. 
Value) String 

PutUnitDouble Sets the value for a key whose type 
(Key, Number (Long) is a unit value formatted as a 
UnitID, Number (Long) double. 


Value) 


Number (Double) 
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The list of commands that comprise an Action (such as an Action created using the Actions palette in the 
Adobe Photoshop CS2 application). 


Note: The actionList object is part of the Action Manager functionality. For details on using the Action 
Manager, see ‘Action Manager’ on page 145. 


Property Value Type What it is 

Application Object (Application) Read-only. The application that the collection belongs 
to. 

Count Number (Long) Read-only. The number of commands that comprise the 
action. 

typename String Read-only. The class name of the referenced 


actionList object. 


With the exception of the clear () method, you use the methods of this object to either get the value of a 
specific type of data in the list or set (put) the value type. 


Method Parameter Type Returns What it does 

Clear Clears the list. 
() 

GetBoolean Boolean Gets the value of a list item of type 
(Index) Number (Long) boolean. 

GetClass Number (Long) Gets the value of a list item of type 
(Index) Number (Long) class. 

GetDouble Number (Double) Gets the value of a list item of type 
(Index) Number (Long) double. 

GetEnumerationType Number (Long) Gets the enumeration type of a list 
(Index) Number (Long) item. 

GetEnumerationValue Number (Long) Gets the enumeration value of a 
(Index) Number (Long) list item. 

GetInteger Number (Long) Gets the value of a list item of type 
(Index) Number (Long) integer. 

GetList ActionList Gets the value of a list item of type 
(Index) Number (Long) list. 

GetObjectType Number (Long) Gets the class ID of a list item of 


(Index) Number (Long) type object. 
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Method Parameter Type Returns What it does (Continued) 
GetObjectValue ActionDescriptor Gets the value of a list item of type 
(Index) Number (Long) object. 
GetPath file Gets the value of a list item of type 
(Index) Number (Long) Alias. 
GetReference ActionReference Gets the value of a list item of type 
(Index) Number (Long) ActionReference. 
GetString String Gets the value of a list item of type 
(Index) Nunes (Long) String. 
GetType PsDescValueType Gets the type of a list item. 
(Index) Number (Long) 
GetUnitDoubleType Number (Long) Gets the unit value type of a list 
(Index) Number (Long) item of type Double. 
GetUnitDoubleValue Number (Double) Gets the unit value of a list item of 
(Index) Number (Long) type double. 
PutBoolean Sets the value to either true or 
(Value) Poo rean false. 
PutClass Sets the class or data type. 
(Value) Number (Long) 
PutDouble Sets the value type as a double. 
(Value) Number (Double) 
PutEnumerated Sets the value type as an 
(EnumType, Number (Long) enumerated, or constant, value. 
Value) Number (Long) 
constantType. VALUE 
See Chapter 4, “Scripting 
Constants”, for information on 
constant values. 
PutInteger Sets the value of a list item of type 
(Value) Number (Long) integer. 
PutList Sets the value of a list item of type 
(Value) ees list or array. 
PutObject Sets the value of a list item of type 
(ClassID, Number (Long) object. 
Value) ActionDescriptor 
PutPath Sets the value of a list item of type 
(Value) ute path. 
PutReference Sets the value of a list item whose 
(Value) Actionnererence type a reference to an object 


created in the script. 
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Method Parameter Type Returns What it does (Continued) 

PutString Sets the value of a list item of type 
(Value) String String. 

PutUnitDouble Sets the value of a list item of type 
(UnitID, Number (Long) unit value represented as a 
Value) Number (Double) 


double. 
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A reference object that contains the data describing the object you are referring to. 


Note: The act ionReference object is part of the Action Manager functionality. See ‘Action Manager’ on 


page 145. 
Property Value type What it does 
Application Object Read-only. The application that the collection 
(Application) 
Se belongs to. 
typename String Read-only. The class name of the referenced Action 
object. 
Method Parameter Type Returns What it does 
GetContainer ActionReference Gets the container object in the 
() containment hierarchy for the 
object. 
GetDesiredClass Number (Long) Gets a number representing the 
() class of the object. 
GetEnumeratedType Number (Long) Gets the enumeration type. See 
() Chapter 4, “Scripting Constants”, 
for information on enumeration 
types and values. 
GetEnumeratedValue Number (Long) Gets the enumeration value. 
() 
GetForm PsReferenceFormType Gets the form of an 
() ActionReference. 
GetIdentifier Number (Long) Gets the identifier value for a 
() reference whose form is identifier. 
Get Index Number (Long) Gets the index value for a 
() reference in a list or array. 
GetName String Gets the name of a reference. 
() 
GetOffset Number (Long) Gets the offset of the object's 
() index value. 
GetProperty Number (Long) Gets the property ID value. 
() 
PutClass Sets the class type of the object. 
(DesiredClass) Number (Long) The class name is required. 
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Method Parameter Type Returns What it does (Continued) 
PutEnumerated Sets the object’s type to 
(DesiredClass, Number (Long) ‘Enumerated’. 
EnumType Number (Long) 
Value) i Number (Long) 
PutIdentifier Sets the value of the identifier. 
(DesiredClass, Number (Long) 
Value) Number (Long) 
PutIndex Sets the object’s index value ina 
(DesiredClass, Number (Long) list. 
Value) Number (Long) 
PutName Sets the object’s name. 
(DesiredClass, Number Long) 
Value) String 
PutOffset Sets the object's offset from the 
(DesiredClass, Number Long) current object. 
Value) Number (Long) 
PutProperty Sets the value of the object's 
; Number (Long) 
D dclass, roperty. 
(DesiredClass Number. (Long) property 


Value) 
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The Adobe Adobe Photoshop CS2 application object, referenced using the pre-defined global app object. 
The app object contains all other Adobe Photoshop CS2 objects. 


Property Value Type What it is 

ActiveDocument Document Read-write. The frontmost document. (Setting this 
property is equivalent to clicking an open 
document in the Adobe Photoshop CS2 application 
to bring it to the front of the screen.) 

Application Object Žž Read-only. The application that the collection 

(Application) 
———— belongs to. 

BackgroundColor Solidcolor Read-write. The color mode for the document's 
background color. 

ColorSettings String Read-write. The name of selected color setting’s set. 

DisplayDialogs PsDialogModes Read-write. The dialog mode for the document, 
which indicates whether or not Adobe Photoshop 
CS2 displays dialogs when the script runs. 

Documents Documents Read-only. The collection of open documents. 

Fonts TextFonts Read-only. The fonts installed on this system. 

ForegroundColor SolidColor Read-write. The default foreground color (used to 
paint, fill, and stroke selections). 

FreeMemory Number (Double) Read-only. The amount of unused memory 
available to Adobe Photoshop CS2. 

Locale String Read-only. The language location of the 
application. 

MacintoshFileTypes array of Strings Read-only. A list of file image types Adobe 
Photoshop CS2 can open. 

Name String Read-only. The application's name. 

Notifiers Notifiers Read-only. The collection of notifiers currently 
configured (in the Scripts Events Manager menu in 
the Adobe Photoshop CS2 application). 

NotifiersEnabled Boolean Read-write. Indication of whether all notifiers are 
enabled or disabled. 

Path file Read-only. The full path to the location of the 
Adobe Photoshop CS2 application. 

PlaybackDisplayDialogs PsDialogModes Read-write. The dialog mode for playback mode, 


which indicates whether or not Adobe Photoshop 
CS2 displays dialogs in playback mode. 
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Property Value Type What it is (Continued) 

PlaybackParameters ActionDescriptor — Read-write. The playback options, which indicate 
the speed at which Adobe Photoshop CS2 plays 
actions. 

Preferences Preferences Read-only. The application preference settings 
(equivalent to selecting Edit > Preferences in the 
Adobe Photoshop CS2 application in Windows or 
Photoshop > Preferences in Mac OS). 

PreferencesFolder Alias Read-only. The full path to the Preferences folder. 

ScriptingVersion String Read-only. The version of the Scripting interface. 

typename String Read-only. The class name of the referenced app 
object. 

Version String Read-only. The version of Adobe Photoshop 
application you are running. 

Visible Boolean Read-write. Indication of whether the Adobe 
Photoshop CS2 application is the front-most/active 
application. 

WinColorSettings String Read-only. Color settings. 

WindowsFileTypes array of Strings Read-only. A list of file image extensions Adobe 
Photoshop CS2 can open. 

Method Parameter Type Returns What it does 

Batch String Runs the batch automation 

(InputFiles, asi of files routine (similar to the Batch 
Action, eae command, or File > 
o T BatchOptions Automate > Batch in the 
aia Adobe Photoshop CS2 
application). 

Note: The inputFiles 
parameter specifies 
the source for the 
files to be 
manipulated by the 
Batch command. 

ChangeColorSettings None Sets Color Settings to a 

( [Name] ee A named set or to the 
[, File]) ee ee contents of a settings file. 
CharIDToTypeID Number (Long) Converts from a four 
(CharID) String character code (character 


ID) to a runtime ID. 
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Method Parameter Type Returns What it does (Continued) 
DoAction none Plays an action from the 
(Action, String Actions palette. 
From) String 
DoJavaScript String Executes the specified 
(JavaScriptCode, Sering JavaScript code. 
[, Arguments] String P à 
[, ExecutionMode] )) PsJavaScriptExecut ionMode 
DoJavaScriptFile String Executes the specified 
(JavaScriptCode, Sering JavaScript code. 
[, Arguments] Sering eee , 
[, ExecutionMode] ) ) PsJavaScriptExecutionMode 
executeAction ActionDescriptor Plays an ActionManager 
(Event ID Number (Long) event. 
[, Descriptor] ActionDescriptor 
[; DisplayDialogs] ) PsDialogModes 
ExecuteActionGet ActionDescriptor Obtains an 
(Reference) ActionReference ActionDescriptor. 
Load file Loads a support document 
(Document ) from the specified location. 
MakeContactSheet String Creates a contact sheet 
(InputFiles armay Oe from the specified files. 
[, Options] ) ContactSheetOptions 
MakePDFPresentation String Creates a PDF presentation 
(InputFiles aera OE tee file from the specified input 
OutputFiles Sering ; ; files. 
[, Options] ) PresentationOptions 
MakePhotoGallery String Creates a Web photo gallery 
(Input Folder see from the files in the 
Output Folder ee : specified input folder. 
[, Options] ) GalleryOptions p d p 9 
MakePhotomerge array of files String Merges multiple files into 
(InputFiles) one; user interaction 
required. 
MakePicturePackage String Creates a picture package 
(InputFiles array OP files from the specified input 
[, Options] ) PicturePackageOptions files: 
Open Document Opens the specified 
(Document String , document as the optionally 
L As]) object (open options) 


Note: See open options for 
individual file types, 
such as 
CameraRawOpenOpti 


onsor 
EPSOpenOptions, etc. 


specified file type. 
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Method Parameter Type Returns What it does (Continued) 

Purge Purges one or more caches. 
(Target) PsPurgeTarget 

StringIDToTypeID Number (Long) Converts from a String ID to 
(StringID) String a runtime ID. 

TypeIDToCharID String Converts from a runtime ID 
(TypeID) Number (Long) to a character ID. 

TypeIDToStringID String Converts from a runtime ID 
(TypeID) Number (Long) to a String ID. 


The following script displays a message box that contains the application version number, the path to the 
application, the amount of memory available, and the number of documents open. 


When the user clicks OK, a second dialog asks whether they would like the foreground and background 


colors set. 


A third dialog offers to open a sample file. If the user clicks OK, the script opens the file eagle.psd from the 
samples folder in the application directory. 


Application.vbs 


Create a Welcome message 


' Use the name and version properties of the application object to append the 
' application's name and version to the Welcome message use vbCrLf to insert a 
' carriage return 

Dim appRef, message, documentsOpen, answer, sampleDocToOpen 


Set appRef = CreateObject ("Photoshop.Application") 


message = "Welcome to " & appRef.Name 
message = message & " version " & appRef.Version & vbCrLf & vbCrLf 


' find out where Photoshop CS2 is installed and add the path to the message add 
' the optional parameter fsName to the path property to display the file system 
' name in the most common format 

messag message & "I’m installed in " & appRef.Path & vbCrLf & vbCrLf 


'see how much memory Photoshop CS2 has to play with 
messag message & "You have this much memory available for Photoshop CS2: " 
messag message & appRef.FreeMemory & vbCrLf & vbCrLf 


' use the Count property of the Documents object to see how many are open 
documentsOpen = appRef.Documents. Count 

message = message & "You currently have " & documentsOpen & " documents open." & 
vbCrLf & vbCrLf 


'display the message to the user 
MsgBox (message) 


answer = MsgBox ("Do you want me to set the foreground and background to my favorite 
colors?", vbYesNo, "Change Colors?") 
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' set the colors 

If answer = vbYes Then 
Randomize ' Initialize random-number generator. 
' I don’t have a favorite color. Why did I ask you may wonder? 
appRef .ForegroundColor.RGB.Red = Rnd() * 255 
appRef .ForegroundColor.RGB.Green = Rnd() * 255 
appRef .ForegroundColor.RGB.Blue = Rnd() * 255 
appRef .BackgroundColor.RGB.Red = Rnd() * 255 
appRef .BackgroundColor.RGB.Green = Rnd() * 255 
appRef .BackgroundColor.RGB.Blue = Rnd() * 255 

End If 


' Open a document 
If documentsOpen = 0 Then 
' use the application’s path and the offset to the samples folder 
sampleDocToOpen = appRef.Path & "Samples\Eagle.psd" 
' compose a message with the name of the file 
message = "Would you like me to open a sample for you? (" 
message = message & sampleDocToOpen & ")" 
' ask the user another question 
answer = MsgBox (message, vbYesNo, "Open Something?") 
' open the document accordingly 
If answer = vbYes Then 
appRef .Open sampleDocToOpen 
End If 
End If 
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The following script presents a progression of images as a PDF slide show. 


PDFPresentation.vbs 


' use all the files in the Samples folder 
Dim appRef, inputFiles(), i, outputFile, options 


Set appRef = CreateObject ("Photoshop.Application") 
' get all the files found in this folder 
Set fsoRef = CreateObject ( "Scripting.FileSystemObject" ) 


Set folderRef = fsoRef.GetFolder( appRef.Path & "Samples\" ) 


ReDim inputFiles(folderRef.Files.Count) 


i=0 

For Each f in folderRef.Files 
inputFiles(i) = f.Path 
ae ees ae a 8 

Next 


' output to the desktop 
outputFile = "C:\\JavaScriptPresentation.pdf" 


' there are defaults but I like to set the options myself 

Set options = CreateObject ("Photoshop.PresentationOptions") 
options.Presentation = true 

options.Encoding = 2 'for PsPDFEncoding --> 2 (psPDFJPEG) 
options.AutoAdvance = true 

options.Interval = 5 

options.Loop = true 

options.Transition = 10 'for PsTransitionType --> 10 (psRandom) 


' create the presentation 
appRef .MakePDFPresentation inputFiles, outputFile, options 
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An object within a document that contains the visual elements of the image (equivalent to a layer in the 
Adobe Photoshop CS2 application). 


Property Value Type What it is 
AllLocked Boolean Read-write. Indicates whether to completely lock the 
layer’s contents and settings. 
Application Object Read-only. The application that the collection belongs 
(Application) 
a to. 
ArtLayer Object Read-only. When LayerType = 1, then this property 
(ArtLayer) . 
returns a reference to the corresponding ArtLayer 
object. See LayerType. 
BlendMode PsBlendMode Read-write. The layer’s blending mode. 
Bounds Array Read-only. An array of coordinates that describes the 
bounding rectangle of the ArtLayer. 
FillOpacity Number (Double) Read-write. The interior opacity of the layer (0.0 - 

100.0). 

Grouped Boolean Read-write. Indication of whether to group this layer 
with the layer beneath it. 

IsBackgroundLayer Boolean Read-write. Indicates whether the layer is a 
background layer or normal layer. 

Note: A document can have only one background 
layer. 

Kind PsLayerKind Read-write. Sets the layer’s kind (such as ‘text layer’) 
for an empty layer. 

Note: Valid only when the layer is empty and when 
IsBackgroundLayer iS false. See 
IsBackgroundLayer. 

Note: You can use the kind property to make a 
background layer a normal layer; however, to 
make a layer a background layer, you must set 
IsBackgroundLayer tO true. 

Layer Object (Layer) Read-only. The Layer corresponding to the ArtLayer. 
LayerSet Object Read-only. When LayerType = 2, then this property 
(LayerSet ) . 
returns a reference to the corresponding LayerSet 
object. See LayerType. 
LayerType PsLayerType Read-write. The type of layer. 
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Property Value Type What it is (Continued) 
LinkedLayers array of Layers Read-only. The layers linked to this layer. 
Note: See Link. 
Name String Read-write. The layer’s name. 
Opacity Number (Double) Read-write. The master opacity of the layer (0.0 - 
100.0). 
Parent Object Read-only. The object's container. 
(Document ) 
PixelsLocked Boolean Read-write. Indicates whether the pixels in the layer’s 
image can be edited using the paintbrush tool. 
PositionLocked Boolean Read-write. Indicates whether the pixels in the layer’s 
image can be moved within the layer. 
TextItem TextItem Read-only. The text item that is associated with the 
layer. 
Note: Valid only when Kind = 2. See Kind. 
TransparentPixelsLocked Boolean Read-write. Indicates whether editing is confined to 
the opaque portions of the layer. 
typename String Read-only. The class name of the referenced 
ArtLayer object. 
Visible Boolean Read-write. Indicates whether the layer is visible. 
Method Parameter Type Returns What it does 
AdjustBrightnessContrast Adjusts the brightness (-100 - 100) 
(Brightness, Number (Long) and contrast (-100 - 100). 
Contrast) Number (Long) 
AdjustColorBalance Adjusts the color balance of the 
( [Shadows] array of Numbers layer’s component channels. For 
[, Midtones] array of Numbers Shadows, Midtones, and 
[, Highlights] array of Numbers 


[, PreserveLuminosity] 


Boolean 


Highlights, the array must 
include three values (-100 - 100), 
which represent cyan or red, 
magenta or green, and yellow or 
blue, when the document mode is 
CMYK or RGB. 


Note: See mode in the Properties 
table of the Document 
object. 
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Method Parameter Type Returns What it does (Continued) 
AdjustCurves Adjusts the tonal range of the 
Array of points ; 
(CurveShape) Geray Array GG: yN) selected channel using up to 
fourteen points. 
AdjustLevels Adjusts the levels of the selected 
(InputRangeStart, Number (Long) channels (InputRangeStart: 0- 
p g Number (Long) 
InputRangeEnd, Number (Double) 253; InputRangeEnd: 
A A Number (Long) (InputRangeStart + 2) - 255; 
A A et) ' Number (Long) Input RangeGamma: 0.10 - 9.99; 
OutputRangeStart: 0 - 253; 
OutputRangeEnd: 
(OutputRangeStart + 2) - 255. 
ApplyAddNoise Applies the Add Noise filter 
(Amount, Number (Double) — (Amount: 0.1% - 400%). 
Distribution, PsNoiseDistribution 
Monochromatic) Boolean 
ApplyAverage Applies the Average filter. 
Q 
ApplyBlur Applies the Blur filter. 
Q 
ApplyBlurMore Applies the Blur More filter. 
Q 
ApplyClouds Applies the Clouds filter. 
Q 
ApplyCustomFilter Applies a custom filter. 
eles Array of twenty-five 
oo Maen Long) Note: Required parameter values 
Scale, Number (Long) E q pa 
offset) Number (Long) define the filter. Refer to 
Adobe Photoshop CS2 Help 
for specific instructions. 
ApplyDeInterlace Applies the De-Interlace filter. 
(RliminateFields, PsEliminateFields 
CreateFields) PsCreateFields 
ApplyDespeckle Applies the Despeckle filter. 


() 


ApplyDifferenceClouds 


() 


ApplyDiffuseGlow 


(Graininess, 
GlowAmount, 
ClearAmount ) 


Number (Long) 
Number (Long) 
Number (Long) 


Applies the Difference Clouds filter. 


Applies the Diffuse Glow filter 
(Graininess: 0 - 10; GlowAmount: 0 
- 20; ClearAmount: 0 - 20). 


VBScript Scripting Reference 


Adobe Photoshop CS2 


VBScript Interface 25 


Method Parameter Type Returns What it does (Continued) 
ApplyDisplace Applies the Displace filter using the 
(Amount Scale, Re a specified horizontal and vertical 

VerticalScale, lumber ong $ 5 ; 

a scale (999 999), mapping type; 

UndefinedAreas i PsUndefinedAreas treatment of un istorte areas, 
String and path to the distortion image 


DisplacementMapFiles) 


ApplyDustAndScratches 


(Radius, 
Threshold) 


ApplyGaussianBlur 
(Radius) 


ApplyGlassEffect 


(Distortion, 
Smoothness, 
Scaling 

[, Invert] 
[, Texture] 
[, TextureFile] ) 


ApplyHighPass 
(Radius) 


ApplyLensBlur 
( [Options] ) 


ApplyLensFlare 


(Brightness, 
FlareCenter, 


LensType) 


ApplyMaximum 
(Radius) 


ApplyMedianNoise 
(Radius) 


ApplyMinimum 
(Radius) 


ApplyMotionBlur 
(Angle, 
Radius) 
ApplyNTSC 
() 


Number (Long) 
Number (Long) 


Number (Double) 


Number (Long) 
Number (Long) 
Number (Long) 
Boolean 
PsTextureType 
File 


Number (Double) 


LensBlurOptions 


Number (Long) 
Array 
PsLensType 


Number (Double) 


Number (Double) 


Number (Double) 


Number (Long) 
Number (Double) 


map. 


Applies the Dust & Scratches filter 
(Radius: 1 - 100; Threshold: 0 - 
255). 


Applies the Gaussian Blur filter 
within the specified radius (in 
pixels) (0.1 - 250.0). 


Applies the Glass filter 
(Distortion: 0-20; Smoothness: 1 
- 15; Scaling (in percent): 50 - 200). 


Applies the High Pass filter within 
the specified radius (in pixels) (0.1 - 
250.0). 


Applies the Lens Blur filter. 


Applies the Lens Flare filter with 
the specified brightness (0 - 300%), 
the x and y coordinates (unit value) 
of the flare center, and the lens 


type. 


Applies the Maximum filter within 
the specified radius (in pixels) (1 - 
100). 


Applies the Median Noise filter 
within the specified radius (in 
pixels) (1 - 100). 


Applies the Minimum filter within 
the specified radius (in pixels) (1 - 
100). 


Applies the Motion Blur filter 
(Angle: -360 - 360; Radius: 1 - 999). 


Applies the NTSC colors filter. 
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Method Parameter Type Returns What it does (Continued) 

ApplyOceanRipple Applies the Ocean Ripple filter in 
(Size, sea peel the specified size (1 - 15) and 
Magnitude) Ee ee magnitude (0 - 20). 

ApplyOffset Moves the layer the specified 
(Horizontal, Number (Double) amount horizontally and vertically 
Vertical Number (Double) (min/ tsd d 
tndefinedäreas) PsOffsetUndefinedAreas nain Max amoun s qepen on 

layer size), leaving an undefined 
area at the layer’s original location. 

ApplyPinch Applies the Pinch filter in the 
(Amount ) Number (Long) specified amount (as a percentage) 


ApplyPolarCoordinates 


(Conversion) 


ApplyRadialBlur 


(Amount, 
BlurMethod, 
BlurQuality) 


ApplyRipple 
(Amount, 
Size) 


ApplySharpen 
() 


ApplySharpenEdges 
() 


ApplySharpenMore 
() 


ApplyShear 


(Curve, 
UndefinedAreas) 


ApplySmartBlur 


(Radius, 
Threshold, 
BlurQuality, 
Mode) 


ApplySpherize 
(Amount, 
Mode) 


PsPolarConversionType 


Number (Long) 
PsRadialBlurMethod 
PsRadialBlurQuality 


Number (Long) 
PsRippleSize 


array of points 
(Array (Array (x, y))) 


PsUndefinedAreas 


Number (Double) 
Number (Double) 
PsSmartBlurQuality 
PsSmartBlurMode 


Number (Long) 
PsSpherizeMode 


(-100 - 100). 


Applies the Polar Coordinates filter. 


Applies the Radial Blur filter in the 
specified amount (1 - 100) using 
either a spin or zoom effect and the 
specified quality. 


Applies the Ripple filter in the 
specified amount (-999 to 999) 
throughout the image and in the 
specified size. 


Applies the Sharpen filter. 


Applies the Sharpen Edges filter. 


Applies the Sharpen More filter. 


Applies the Shear filter (curve: 2 - 
255 points). 


Note: You must define at least two 
points in the Curve 
parameter. 


Applies the smart blur filter 
(Radius: 0.1 - 100.0; Threshold: 0.1 
- 100.0). 


Applies the Spherize filter in the 
specified amount (as percentage) 
(-100 - 100). 
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Method Parameter Type Returns What it does (Continued) 
ApplyStyle Applies the specified style to the 
(StyleName) String layer. 
Note: You must use a style from 
the Styles list in the Layer 
Style dialog. 
ApplyTextureFill Applies the Texture Fill filter. 
(TextureFile) String 
ApplyTwirl Applies the Twirl filter at the 
(Angle) Number (Long) specified angle (-999 - 999). 
ApplyUnSharpMask Applies the Unsharp Mask filter 

(Amount, SO a (Amount: 1 - 500 as percent; 

Radius, lumber lo) e econ _ : 0- 

ene) Number (Long) Radius: 0.1 - 250.00; Threshold: 0 
255). 

ApplyWave Applies the Wave filter 

(GeneratorNumber, bt (Long) (GeneratorNumber:? 1 - 999; 

MinimumWavelength, omer on MinimumWavelength: 1 - 998; 

MaximumWavelength, Number (Long) ‘ 

MinimumAmplitude Number (Long) MaximumWavelength: 

MaximumAmplitude, Number (Long) 2 - MinimumWavelength + 1; 

HorizontalScale, PERAI ae MinimumAmplitude: 1 - 998; 

VerticalScale, BENA MaximumAmplitude: 

W , P= a ` ` 7 . 

Kle tar ae E PsUndefinedAreas 2 -MinimumAmplitude + 1; 

RandomSeed) ' Number (Long) AmountScale: 1% - 100%; 
VerticalScale: 1% - 100%). 

ApplyZigZag Applies the Zigzag filter (Amount: 

(amount, Number Long) -100 - 100; Ridges: 0 - 20). 

Ridges, Number (Long) 

Style) PsZigZagType 
AutoContrast Adjusts the contrast of the selected 
() channels automatically. 
AutoLevels Adjusts the levels of the selected 

() channels using the auto levels 
option. 

Clear Cuts the layer without moving it to 

() the clipboard. 

Copy Copies the layer to the clipboard. 

( [Merge] ) Poeren When the optional argument is set 
to true, a merged copy is 
performed (that is, all visible layers 
are copied to the clipboard). 

Cut Cuts the layer to the clipboard. 
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Method 


Parameter Type 


Returns 


What it does (Continued) 


Desaturate 
() 


Duplicate 

( [RelativeObject] 

[, InsertionLocation] ) 
Equalize 

() 


Invert 
() 


MixChannels 


(OutputChannels 
[, Monochrome] ) 


Object (Layer) 
PsElement Placement 


Object (Layer) 


array of array of 
numbers (double) 
boolean 


Object 
(Layer) 


ArtLayer 


Converts a color image toa 
grayscale image in the current 
color mode by assigning equal 
values of each component color to 
each pixel. 


Creates a duplicate of the object on 
the screen. 


Redistributes the brightness values 
of pixels in an image to more 
evenly represent the entire range 
of brightness levels within the 
image. 


Inverts the colors in the layer by 
converting the brightness value of 
each pixel in the channels to the 
inverse value on the 256-step 
color-values scale. 


Links the layer with the specified 
layer. 


Merges the layer down, removing 
the layer from the document; 
returns a reference to the art layer 
that this layer is merged into. 


Modifies a targeted (output) color 
channel using a mix of the existing 
color channels in the image. 
(Output Channels = An array of 
channel specifications. For each 
component channel, specify a list 
of adjustment values (-200 - 200) 
followed by a 'constant' value (-200 
- 200).) 


Note: When Monochrome = true, 
the maximum number of 
channel value specifications 
is 1. 


Note: Valid only when 
Document .Mode = 2 OF 


Document .Mode 3. 


Note: RGB arrays must include four 
doubles. CMYK arrays must 
include five doubles. 
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Method Parameter Type Returns What it does (Continued) 
Move Moves the layer relative to the 
(ApplicationObject, pues aoe or object specified in parameters. 
InsertionLocat ion) PsElement Placement 
Note: For art layers, only the 
constant values 3 and 2 are 
valid. 
For layer sets, only the 
constant values 3 and 0 are 
valid. 
PhotoFilter Adjust the layer’s color balance and 
( [Fil1Color] reat oe i temperature as if a color filter had 
: umber ong . f : 
[, Density] SUERA been applied (Density: 1% - 


[, PreserveLuminosity] ) 


Posterize 
(Levels) 


Rasterize 
(Target) 


Resize 


( [Horizontal] 
[, Vertical] 
[, Anchor] ) 


Rotate 


(Angle 
[, Anchor] ) 


SelectiveColor 


(SelectionMethod 
, Reds] 

, Yellows] 

, Greens] 

, Cyans] 

, Blues] 

, Magentas] 

, Whites] 

, Neutrals] 

, Blacks] ) 


Number (Long) 


PsPurgeTarget 


Number (Double) 
Number (Double) 
PsAnchorPosition 


Number (Double) 
PsAnchorPosition 


PsAdjustmentReference 


Array of Numbers (Long 
Array of Numbers (Long 
Array of Numbers (Long 
Array of Numbers (Long 
Array of Numbers (Long 
Array of Numbers (Long 
Array of Numbers (Long 
Array of Numbers (Long 
Array of Numbers (Long 


100%). 


Specifies the number of tonal 
levels (2 - 255) for each channel 
and then maps pixels to the closest 
matching level. 


Converts the targeted contents in 
the layer into a flat, raster image. 


Resizes the layer to the specified 
dimensions (as a percentage of its 
current size) and places it in the 
specified position. 


Rotates rotates the layer around 
the specified anchor point. 


Modifies the amount of a process 
color in a specified primary color 
without affecting the other 
primary colors. 


Note: Each color array must have 
four components. 
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Method Parameter Type Returns What it does (Continued) 
ShadowHighlight Adjusts the range of tones in the 
( [ShadowAmount ] Number (Long) image's Shadows and highlights 
, ShadowWidth] ee ao (ShadowAmount: 0 - 100 as percent; 
ee Number (Long) ShadowWidth: 0- 100 as percent; 
, HighlightWidth] Number (Long) ShadowRadius: 0 - 2500 in pixels; 
, HighlightRadius] Number (Long) HighlightAmount: 0 - 100 as 
i ColorCorrection] ace seal percent; HighlightWidth: 0- 100 
ea Number (Double) as percent; HighlightRadius:0- 
| WhiteClip) ) Number (Double) 2500 in pixels; ColorCorrection: 
-100 - 100; MidtoneCont rast: -100 
- 100; BlackClip: 0.000 - 50.000; 
WhiteClip: 0.000 - 50.000). 
Threshold Converts grayscale or color images 
(Level) Number (Long) to high-contrast, B/W images by 
converting pixels lighter than the 
specified threshold to white and 
pixels darker than the threshold to 
black (level: 1 - 255). 
translate Moves the layer the specified 
( [Deltax] UnitValue amount (in pixels) relative to its 
[, DeltaY]) Levene current position. 
unlink Unlinks the layer. 


() 


The following script closes any open documents (files), then opens each file in the Samples folder, creating 
an art layer for each image and using the image's file name as the layer name. 


ArtLayer.vbs 


Dim appRef, startRulerUnits, 


startTypeUnits, 


startDisplayDialogs, mergedDoc 


Dim fsoRef, folderRef, topLeftH, topLeftV, docH, docV, docName, selRegion 
Dim x, y, layerl, layer2 


Set appRef = CreateObject ("Photoshop.Application") 


' Save the current preferences 

startRulerUnits = appRef.Preferences.RulerUnits 
startTypeUnits = appRef.Preferences.TypeUnits 
startDisplayDialogs = appRef.DisplayDialogs 


' Set Photoshop CS2 to use pixels and display no dialogs 
appRef.Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels) 

appRef .Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels) 
appRef .DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs) 


' Close all the open documents 
Do While appRef.Documents. Count 

appRef .ActiveDocument . Close () 
Loop 
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' Create a new document to merge all the samples into 

Set mergedDoc = appRef.Documents.Add(1000, 1000, 72, "Merged Samples", 2, 3, 1) 
‘enumerated values 2 = PsNewDocumentMode --> 2 (PSNewRGB) and 

'3 = PsDocumentFill --> 3 (psTransparent) 


' get all the files found in this folder 
Set fsoRef = CreateObject ( "Scripting.FileSystemObject" ) 
Set folderRef = fsoRef.GetFolder( appRef.Path & "Samples\" ) 


Randomize 


' open each file 
For Each f in folderRef.Files 
appRef.Open f.Path 


' use the document name for the layer name in the merged document 
docName = appRef .ActiveDocument .Name 


' flatten the document so we get everything and then copy 
appRef .ActiveDocument.flatten() 

appRef .ActiveDocument .Selection.SelectAl1l1 () 

appRef .ActiveDocument .Selection.Copy () 


' don’t save anything we did 
appRef .ActiveDocument .Close (2) 
'the enumerated value Close(2) = PsSaveOptions >2 (psDoNotSaveChanges) 


' make a random selection on the document to paste into 

' by dividing the document up in 4 quadrants and pasting 

' into one of them by selecting that area 

topLeftH Int (Rnd() * 2) 

topLeftV = Int(Rnd() * 2) 

' MsgBox topLeftH & ":" & topLeftV 

docH = appRef.ActiveDocument.Width / 2 

docV = appRef.ActiveDocument.Height / 2 

selRegion = Array( Array( topLeftH * docH, topLeftV * docV), _ 
Array( topLeftH * docH + docH, topLeftV * docV), 


Array( topLeftH * docH + docH, topLeftV * docV + docv) , e: 
Array( topLeftH * docH, topLeftV * docV + docV), 
Array ( topLeftH * docH, topLeftV * docV)) 


appRef .ActiveDocument .Selection.Select (selRegion) 
appRef .ActiveDocument . Paste () 


' change the layer name and opacity 

appRef .ActiveDocument .ActiveLayer.Name = docName 

appRef .ActiveDocument .ActiveLayer.FillOpacity = 50 
Next 


' sort the layers by name 
x = 0 
y = 0 
for x = 1 To appRef .ActiveDocument .Layers.Count 
for y = 1 To appRef .ActiveDocument.Layers.Count - 1 
Set layerl = appRef .ActiveDocument.Layers(y) 
Set layer2 = appRef .ActiveDocument.Layers(y + 1) 
If layerl.Name --> layer2.Name Then 
layerl.move layer2, 4 
End If 
Next 
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Next 


' Reset the application preferences 

appRef .Preferences.RulerUnits = startRulerUnits 
appRef .Preferences.TypeUnits = startTypeUnits 
appRef .DisplayDialogs = startDisplayDialogs 
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The collection of artLayer objects in the document. 


Property Value Type What it is 
Application Object Read-only. The application that the collection belongs 
(Application) 

to. 

Count Number (Long) Read-only. The number of elements in the artLayers 
collection. 

Item Object (ArtLayer) | Read-only. Used to get the element from the 
collection. 

Parent Object (Document) Read-only. The object's container. 

typename String Read-only. The class name of the referenced 


ArtLayers object. 


Method Parameter Type Returns What it does 

Add ArtLayer Creates anew ArtLayer in the 
() document. 

Index Number (long) Gets an element from the ArtLayers 
(ItemPtr) Object (Artlayer) collection. 

RemoveAll Nothing Removes all elements from the 


() ArtLayers collection. 
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Property Value type What it is 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

Destination PsBatchDestinationType /Read-write. The type of destination for the 
processed files. Default: 1 (psNoDest ination). 

DestinationFolder file Read-write. The folder location for the processed 
files. 

Note: Valid only when Destination =3 
(psFolder) . See Destination. 

ErrorFile file Read-write. The file in which to log errors 
encountered. 

Note: To display errors on the screen (and stop 
batch processing when errors occur) leave 
blank. 

FileNaming Array of | Read-write. A list of file naming options 
(PsFileNamingType : . 
options) (maximum: 6). 
Note: Valid only when Destination =3 
(psFolder). See Destination. 
MacintoshCompatible Boolean Read-write. Indication of whether to make the 
final file names Macintosh compatible. Default: 
true: 

Note: Valid only when Destination =3 
(psFolder). See Destination. 

OverrideOpen Boolean Read-write. Indication of whether to override 
action open commands. Default: false. 

OverrideSave Boolean Read-write. Indication of whether to override save 
as action steps with the specified destination. 

Default: false. 

Note: Valid only when Destination =3 
(psFolder).Or Destination =2 
(psSaveAndClose) . See Destination. 

StartingSerial Number (Long) Read-write. The starting serial number to use in 


naming files. Default: 1. 


Note: Valid only when Destination =3 
(psFolder). See Destination. 
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Property Value type What it is (Continued) 
SuppressOpen Boolean Read-write. Indication of whether to suppress the 


file open options dialogs. Default: false. 


SuppressProfile Boolean Read-write. Indication of whether to suppress the 
color profile warnings. Default: false. 


typename String Read-only. The class name of the referenced 
batchOptions object. 


UnixCompatible Boolean Read-write. Indication of whether to make the 
final file name Unix’ compatible. Default: true. 


Note: Valid only when Destination =3 
(psFolder). See Destination. 


WindowsCompatible Boolean Read-write. Indication of whether to make the 
final file names Windows compatible. Default: 


true. 


Note: Valid only when Destination =3 
(psFolder). See Destination. 
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Options to be specified when converting an image to Bitmap mode. 


Note: Convert color images to grayscale before converting the image to bitmap mode. See ‘desaturate’ on 
page 62 (in the Properties table of the ArtLayer object). 


Property Value Type What it is 
Angle Number (Double) Read-write. The angle (in degrees) at which to 
orient individual dots (-180 - 180). See Shape. 
Note: Valid only when Method = 4. See Method. 
Application Object (Application) Read-only. The application that the collection 
belongs to. 
Frequency Number (Double) Read-write. The number of printer dots (per inch) to 
use (1.0 - 999.99). 
Note: Valid only when Method = 4.See Method. 
Method PsBitmapConversionType Read-write. The conversion method to use. Default: 
3. 
PatternName String Read-write. The name of the pattern to use. 
Note: Valid only when Method = 5. See Method. 
Resolution Number (Double) Read-write. The output resolution in pixels per inch. 
Default: 72.0. 
Shape PsBitmapHalfToneType Read-write. The dot shape to use. 
Note: Valid only when Method = 1.See Method. 
typename String Read-only. The class name of the referenced 


BitmapConversionOptions object. 
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Options that can be specified when saving a document in BMP format. 


Property Value Type What it is 
AlphaChannelsd Boolean Read-write. Indication of whether to save the 
alpha channels. 
Application Object (Application) Read-only. The application that the collection 
belongs to. 
Depth PsBitmapConversionTy Read-write. The number of bits per channel. 
be 
FlipRowOrder Boolean Read-write. Indication of whether to write the 
image from top to bottom. Default: false. 
Note: Available only when ostype = 2. 
See OSType. 
OSType PsOperatingSystem Read-write. The target OS. Default: 2. 
RLECompression Boolean Read-write. Indication of whether to use RLE 
compression. 
Note: Available only when ostype = 2. 
See OSType. 
typename String Read-only. The class name of the referenced 


BMPSaveOptions object. 
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Options that can be specified when opening a document in Camera Raw format. 


Property Value type What it is 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

BitsPerChannel PsBitsPerChannelType Read-write. The number of bits per channel. 

BlueHue Number (Long) Read-write. The blue hue of the shot (-100 - 100). 

BlueSaturation Number (Long) Read-write. The blue saturation of the shot (-100 - 
100). 

Brightness Number (Long) Read-write. The brightness of the shot (0 - 150). 

ChromaticAberrationBY Number (Long) Read-write. The chromatic aberration B/Y of the 
shot (-100 - 100). 

ChromaticAberrationRC Number (Long) Read-write. The chromatic aberration R/C of the 
shot (-100 - 100). 

ColorNoiseReduction Number (Long) Read-write. The color noise reduction of the shot 
(0 - 100). 

ColorSpace PsColorSpaceType Read-write. The colorspace for the image. 

Contrast Number (Long) Read-write. The contrast of the shot (-50 - 100). 

Exposure Number (Double) Read-write. The exposure of the shot (4.0 - 4.0). 

GreenHue Number (Long) Read-write. The green hue of the shot (-100 - 100). 

GreenSaturation Number (Long) Read-write. The green saturation of the shot (-100 
- 100). 

LuminanceSmoothing Number (Long) Read-write. The luminance smoothing of the shot 
(0 - 100). 

RedHue Number (Long) Read-write. The red hue of the shot (-100 - 100). 

RedSaturation Number (Long) Read-write. The red saturation of the shot (-100 - 
100). 

Resolution Number (Double) Read-write. The resolution of the document in 
pixels per inch (1 - 999). 

Saturation Number (Long) Read-write. The saturation of the shot (-100 - 100). 

Settings PsCameraRAWSettingsTy |Read-write. The global settings for all Camera 

pe RAW options. 
Shadows Number (Long) Read-write. The shadows of the shot (0 - 100). 
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Property Value type What it is (Continued) 

ShadowTint Number (Long) Read-write. The shadow tint of the shot (-100 - 
100). 

Sharpness Number (Long) Read-write. The sharpness of the shot (0 - 100). 

Size PsCameraRAWSize Read-write. The size of the new document. 

Temperature Number (Long) Read-write. The temperature of the shot (2000 - 
50000). 

Tint Number (Long) Read-write. The tint of the shot (-150 - 150). 

typename String Read-only. The class name of the referenced 


CameraRawOpenOptions object. 


VignettingAmount Number (Long) Read-write. The vignetting amount of the shot 
(-100 - 100). 

VignettingMidpoint Number (Long) Read-write. The vignetting mid point of the shot 
(-100 - 100). 

WhiteBalance PsWhiteBalanceType Read-write. The white balance options for the 


image. 
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Object that stores information about a color element in the image, analogous to a plate in the printing 
process that applies a single color. The document's color mode determines the number of default 
channels; for example, an RGB document has four default channels: 


e Acomposite channel: RGB 


e Three component channels: red, green, blue 


A channel can also be an alpha channel, which stores selections as masks, or a spot channel, which stores 


spot colors. 
Property Value Type What it is 
Application Object (Application) Read-only. The application that the collection belongs to. 
Color Object (SolidColor) Read-write. The color of the channel. 
Note: Not valid when Type = 1. 
Histogram ae DF 256 Numbers Read-only. A histogram of the color of the channel. 
ong 
Note: Not valid when Type = 1. For component channel 
histogram values, use the Histogram property of 
the Document object instead. See Histogram. 
Kind PsChannelType Read-write. The channel type. 
Name String Read-write. The channel's name. 
Opacity Number (Double) Read-write. The opacity to use for alpha channels or the 
solidity to use for spot channels (0 - 100). 
Note: Valid only when Type = 2 or Type = 3. 
Parent Object (Document) Read-only. The object's container. 
typename String Read-only. The class name of the referenced channel 
object. 
Visible Boolean Read-write. Indicates whether the channel is visible. 
Method Parameter Type Returns What it does 
Delete Deletes the channel. 
() 
Duplicate Channel Duplicates the channel. 
( [TargetDocument] ) Document 
Merge Merges a spot channel into the 


() 


component channels. 
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The collection of channel objects in the document. See ‘Channel’ on page 40. 


Property Value Type What it is 
Application Object Read-only. The application that the collection belongs to. 
(Application) 
Count Number (Long) Read-only. The number of elements in the channels 
collection. 
Item Read-only. Gets an element from the collection. 
Object (Channel) 
typename String Read-only. The class name of the referenced Channels 
object. 
Method Parameter Type Returns What it does 
Add Channel Creates anew Channel object. 
() 
Index Number (Long) 
(ItemPtr) Object (Channel) 
RemoveAll Removes all Channe1 objects from the 


() 


Channels collection. 


The following script checks for any open documents (files); if no documents are open, it opens eagle. psd 


in the Samples folder. 


The script then creates the histogram for each channel in the document and creates a log file named 
Histogram.log on your C:\ drive. The file maps out the histogram for each channel and includes the 


following information: 


e Total pixel count 


e Mean pixel count per row 


e Standard deviation of pixels per row 


e Median pixels per row 


e Pixel count row by row, represented in rows of Xs, produces a strobe effect, as a progression of dialogs 


display. 


Histogram.vbs 
Dim appRef, startRulerUnits, 


startTypeUnits, startDisplayDialogs, docRef 


Dim totalCount, channelIndex, activeChannels, myChannels, secondaryIndex 
Dim largestCount, histogramIndex, pixelsPerX, outputX, a, visibleChannelCount 
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Dim aChannelArray(), aChannelIndex, oFileSys, fileOut, hist 
Set appRef = CreateObject ("Photoshop.Application") 


' Save the current preferences 

startRulerUnits = appRef.Preferences.RulerUnits 
startTypeUnits = appRef.Preferences.TypeUnits 
startDisplayDialogs = appRef.DisplayDialogs 


' Set Photoshop CS2 to use pixels and display no dialogs 

appRef .Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels) 

appRef .Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels) 
appRef .DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs) 


' if there are no documents open then try to open a sample file 
If appRef.Documents.Count = 0 Then 

appRef .Open(appRef.Path + "/Samples/Eagle.psd") 
End If 


Set docRef = appRef .ActiveDocument 


' create the output file 
Set oFileSys = CreateObject ("Scripting.FileSystemObject") 
Set fileOut = oFileSys.CreateTextFile("C:\\Histogram.log") 


' write out a header 
fileOut.Write "Histogram report for " & docRef.Name 


' find out how many pixels I have 
totalCount = docRef.Width * docRef .Height 


' more info to the out file 
fileOut .WriteLine " with a total pixel count of " & totalCount 


' remember which channels are currently active 
activeChannels = appRef.ActiveDocument .ActiveChannels 


' document histogram only works in these modes 
If docRef.Mode = 2 Or docRef.Mode = 3 Or docRef.Mode = 6 Then 
‘enumerated values = PsDocumentMode --> 2 (psRGB), 3 (psCMYK), 6 (psIndexedColor) 


' activate the main channels so we can get the document’s histogram 
' using the TurnOnDocumentHistogramChannels function 
Call TurnOnDocumentHistogramChannels (docRef ) 


' Output the documents histogram 
Call OutputHistogram(docRef.Histogram, "Luminosity", fileOut) 
End If 


' local reference to work from 
Set myChannels = docRef.Channels 


' loop through each channel and output the histogram 
For channelIndex = 1 To myChannels. Count 
' the channel has to be visible to get a histogram 
myChannels (channelIndex) .Visible = true 


' turn off all the other channels 
for secondaryIndex = 1 to myChannels. Count 
If Not channelIndex = secondaryIndex Then 
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myChannels (secondaryIndex) .Visible = false 
End If 
Next 


' Use the function to dump the histogram 

Call OutputHistogram(myChannels (channelIndex) .Histogram, 
myChannels (channelIndex) .Name, fileOut) 
Next 


' close down the output file 
fileOut.Close 


' reset the active channels 
docRef .ActiveChannels = activeChannels 


' Reset the application preferences 

appRef .Preferences.RulerUnits = startRulerUnits 
appRef .Preferences.TypeUnits = startTypeUnits 
appRef .DisplayDialogs = startDisplayDialogs 


' Utility function that takes a histogram and name 

' and dumps to the output file 

Private Function OutputHistogram (inHistogram, inHistogramName, inOutFile) 
' find out which count has the largest number 
' I scale everything to this number for the output 
largestCount = 0 


' a simple indexer I can reuse 
histogramIndex = 0 


' search through all and find the largest single item 
For Each hist In inHistogram 
histogramCount = histogramCount + CLng (hist) 


If CLng (hist) --> largestCount Then 
largestCount = CLng (hist) 
End If 
Next 


'These should match 

If Not histogramCount = totalCount Then 
MsgBox "Something bad is happening!" 

End If 


inOutFile.WriteLine "This histogram has a pixel count of " & histogramCount 
inOutFile.WriteLine 


'see how much each "Xx" is going to count as 
pixelsPerX = largestCount / 100 


‘output this data to the file 
inOutFile.WriteLine "One X = " & pixelsPerX & " pixels." 


‘output the name of this histogram 
inOutFile.WriteLine inHistogramName 


inOutFile.WriteLine "Mean Pixels: " & AverageHistogram(inHistogram) 
inOutFile.WriteLine "Std. Dev. Pixels: " & 
StandardDeviationHistogram(inHistogram) 
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inOutFile.WriteLine "Median Pixels: " & MedianHistogram(inHistogram, 


histogramCount ) 


' loop through all the items and output in the following format 


' 001 
' 002 


' For histogramIndex = 0 To (inHistogram.Count - 1) 


histogramIndex = 0 
For Each hist in inHistogram 


' I need an extra "0" for this line item to keep everything in line 


If histogramIndex < 10 Then 
inOutFile.Write "0" 
End If 


' I need an extra "0" for this line item to keep everything in line 


If histogramIndex < 100 Then 
inOutFile.Write "0" 
End If 


' output the index to file 
inOutFile.Write histogramIndex 


' some spacing to make it look nice 
inOutFile.Write " " 


'figure out how many X’s I need 


outputX = CDbl (hist) / largestCount * 100 


‘output the X's 
For a = 0 to outputX ' (outputxX - 1) 
inOutFile.Write "X" 
Next 
inOutFile.WriteLine 
histogramIndex = histogramIndex + 1 
Next 


inOutFile.WriteLine 


End Function 


' Function to active all the channels according to the document’s mode 


' Takes a document reference for input 


Private Function TurnOnDocumentHistogramChannels 
' see how many channels we need to activate 


visibleChannelCount = 0 


"based on the mode of the document 
Select Case inDocument .Mode 


Case 1 

visibleChannelCount = 1 
Case 5 

visibleChannelCount = 1 
Case 6 

visibleChannelCount = 1 
Case 8 

visibleChannelCount = 2 


Case 2 


(inDocument ) 
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visibleChannelCount = 3 
Case 4 
visibleChannelCount = 3 
Case 3 
visibleChannelCount = 4 
Case 8 
visibleChannelCount = 4 
Case 7 
visibleChannelCount = (inDocument.Channels.Count + 1) 
Case Else 
visibleChannelCount = (inDocument.Channels.Count + 1) 
End Select 


' now get the channels to activate into a local array 
ReDim aChannelArray (visibleChannelCount ) 


' index for the active channels array 

aChannelIndex = 1 

For channelIndex = 1 to inDocument.channels. Count 
If channelIndex <= visibleChannelCount Then 
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Set aChannelArray (aChannelIndex) = inDocument.Channels (channel Index) 
aChannelIndex = aChannelIndex + 1 
End If 
Next 


End Function 


Private Function StandardDeviationHistogram(inputArray) 
Dim numPixels, suml, sum2, x, gray 


numPixels = 0 
suml = 0.0 
sum2 = 0.0 


' Compute totals for the various statistics 
For gray = 0 To 255 

x = inputArray (gray) 

numPixels = numPixels + x 

suml = suml + x * gray 


sum2 = sum2 + x * (gray * gray) 
Next 
StandardDeviationHistogram = Sqr((sum2 - (suml * suml) / numPixels) 


1)) 
End Function 


Private Function AverageHistogram(inputArray) 
Dim numPixels, suml, sum2, x, gray 


numPixels = 0 
suml = 0.0 
sum2 = 0.0 


' Compute totals for the various statistics 
For gray = 0 To 255 

x = inputArray (gray) 

numPixels = numPixels + x 

suml = suml + x * gray 


/ (numPixels - 
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sum2 = sum2 + x * (gray * gray) 
Next 


AverageHistogram = suml / numPixels 
End Function 


Private Function MedianHistogram(inputArray, numPixels) 
Dim gray, total, mid 


gray = 0 
total = inputArray (0) 
mid = (numPixels +1) / 2 


Do While (total < mid) 

gray = gray + 1 

total = total + inputArray (gray) 
Loop 


MedianHistogram = gray 


End Function 
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Property Value Type What it is 
Application ve T a Read-only. The application that the collection belongs to. 
Black Number (Double) Read-write. The black color value (as percent) (0.0 - 100.0). 
Cyan Number (Double) Read-write. The cyan color value (as percent) (0.0 - 100.0). 
Magenta Number (Double) Read-write. The magenta color value (as percent) 

(0.0 - 100.0). 
typename String Read-only. The class name of the referenced cmyKCcolor object. 
Yellow Number (Double) Read-write. The yellow color value (as percent) 


(0.0 - 100.0). 
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Property Value Type What it is 

AcrossFirst Boolean Read-write. Indication of whether to place the 
images horizontally (left to right, then top to 
bottom) first. Default: true. 

BestFit Boolean Read-write. Indication of whether to rotate images 
for the best fit. Default: false. 

Caption Boolean Read-write. Indication of whether to use the 
filename as a caption for the image. Default: true. 

ColumnCount Number (Long) Read-write. The number of columns to include 
(1 - 100; default: 5). 

Flatten Boolean Read-write. Indication of whether to flatten all layers 
in the final document. Default: true. 

Font PsGalleryFontType — Read-write. The font used for the caption. Default: 1. 

FontSize Number (Long) Read-write. The font size to use for the caption. 
Default: 12. 

Height Number (Long) Read-write. The height (in pixels) of the resulting 
document (100 - 2900; default: 720). 

Horizontal Number (Long) Read-write. The horizontal spacing (in pixels) 
between images (0 - 29000; default: 1). 

Mode PsNewDocumentMode Read-write. The document color mode. Default: 2 
(pSsNewRGB). 

Resolution Number (Double) Read-write. The resolution of the document in pixels 
per inch (35 - 1200; default: 72 . 0). 

RowCount Number (Long) Read-write. The number of rows to use (1 - 100; 
default: 6). 

typename String Read-only. The class name of the referenced 
contactSheetOptions object. 

UseAutoSpacing Boolean Read-write. Indication of whether to auto space the 
images. Default: true. 

Vertical Number (Long) Read-write. The vertical spacing (in pixels) between 
images (0 - 29000; default: 1). 
Note: Valid only when UseAutoSpacing = false. 

Width Number (Long) Read-write. The width (in pixels) of the resulting 


document (100 - 2900; default: 576). 
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Options that can be specified when saving a CMYK document in DCS1 format. 


Property Value Type What it is 

Application n an Read-only. The application that the collection belongs to. 
DCS PsDCSType Read-write. Default: 3. 

EmbedColorProfile Boolean Read-write. Indication of whether to embed the color 


profile in the document 


Encoding PsSaveEncoding |Read-write. The type of encoding to use for document. 
Default: 1. 
HalftoneScreen Boolean Read-write. Indication of whether to include halftone 


screen. Default: false. 


Interpolation Boolean Read-write. Indication of use image interpolation. Default: 
false) 

Preview PsPreviewType Read-write. The type of preview. Default: 3. 

TransferFunction Boolean Read-write. Indication of whether to include the Transfer 


functions to compensate for dot gain between the image 
and film. Default: false. 


typename String Read-only. The class name of the referenced 
DCS1_SaveOptions object. 


VectorData Boolean Read-write. Indication of whether to include vector data. 


Note: Valid only if the document includes vector data 
(un-rasterized text). 
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Options that can be specified when saving a CMYK document in DCS2 format. 


Property Value Type What it is 
Application Object Read-only. The application that the collection 
(Application) 
belongs to. 

DCS PsDCSType Read-write. The type of composite file to create. 
Default: 1. 

EmbedColorProfile Boolean Read-write. Indication of whether to embed the color 
profile in the document. 

Encoding PsSaveEncoding Read-write. The type of encoding to use. Default: 1. 

HalftoneScreen Boolean Read-write. Indication of whether to include the 
halftone screen. Default: false. 

Interpolation Boolean Read-write. Indication of whether to use image 
interpolation. Default: false. 

MultiFileDCS Boolean Read-write. Indication of whether to save color 
channels as multiple files or a single file. Default: 
false. 

Preview PsPreviewType Read-write. The preview type. Default: 3. 

SpotColors Boolean Read-write. Indication of whether to save spot colors. 

TransferFunction Boolean Read-write. Indication of whether to include the 
Transfer functions to compensate for dot gain 
between the image and film. Default: false. 

typename String Read-only. The class name of the referenced 
DCS2_SaveOptions object. 

VectorData Boolean Read-write. Indication of whether to include vector 


data. 


Note: Valid only if the document includes vector 
data (un-rasterized text). 
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The active containment object for layers and all other objects in the script; the basic canvas for the file. 


Note: In Adobe Photoshop CS2, a document can also be referred to as an image or a canvas. 


e The term image refers to the entire document and its contents. You can trim or crop an image. 
You resize an image using the ResizeImage () method. 


e The term canvas refers to the space in which the document sits on the screen. You can rotate or 
flip the canvas. You resize the canvas using the ResizeCanvas () method. 


Property Value Type What it is 
ActiveChannels peed (Channel Read-write. The selected channels. 
objects 
ActiveHistoryBrushSource Object Read-write. The history state to use with the 
(HistoryState) j 
history brush. 
ActiveHistoryState Object Read-write. The selected HistoryState object. 
(HistoryState) 
ActiveLayer Object (Layer) Read-write. The selected layer. 
Application Object Read-only. The application that the collection 
(Application) belongs to 
ArtLayers Object (ArtLayers) Read-only. The artLayers collection. 
BackgroundLayer Object (ArtLayer) Read-only. Indicates whether the layer is a 
background layer. 
BitsPerChannel PsBitsPerChannelTyp Read-write. The number of bits per channel. 
5 
Channels Object (Channels) |Read-write. The Channels collection. 
ColorProfileName String Read-write. The name of the color profile. 


Note: Valid only when 
ColorProfileType = 3 or 


ColorProfileType = 2.See 
ColorProfileType. 
ColorProfileType PsColorProfileType Read-write. The type of color model that defines 


the document's working space. 


ComponentChannels seme (Channel Read-only. A list of the component color channels. 
objects 

Ful1lName Strong Read-only. The full path name of the document. 

Height Number (Long) Read-only. The height of the document (unit 


value). 
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Property Value Type What it is (Continued) 
Histogram Array of 256 Read-only. A histogram showing the number of 
Numbers (Long) ; : : 
pixels at each color intensity level for the 
composite channel. 
Note: Valid only when Mode = 2;Mode = 3;0r 
Mode = 6. See Mode. 
HistoryStates Read-only. The HistoryStates collection. 
Object 
(HistoryStates) 
Info Object Read-only. Metadata about the document. 
(Document Info) 
LayerComps Object (LayerComps) Read-only. The LayerComps collection. 
Layers Object (Layers) Read-only. The Layers collection. 
LayerSets Object (LayerSets) Read-only. The LayerSets collection. 
Managed Boolean Read-only. Indicates whether the document a is 
workgroup document. 
Mode PsDocumentMode Read-only. The color profile. 
Name String Read-only. The document's name. 
Parent Object | Read-only. The Document object's container. 
(Application) 
Path String Read-only. The path to the document. 
PathItems Object (PathItems) Read-only. The PathiItems collection. 
PixelAspectRatio Number (Double) Read-write. The (custom) pixel aspect ratio to use 
(0.100 - 10.000). 
QuickMaskMode Boolean Read-write. Indicates whether the document is in 
Quick Mask mode. 
Resolution Number (Double) Read-only. The document's resolution (in pixels 
per inch). 
Saved Boolean Read-only. Indicates whether the document has 
been saved since the last change. 
Selection Object (Selection) Read-only. The selected area of the document. 
typename String Read-only. The class name of the Document 
object. 
Width Number (Double) Read-only. The width of the document (unit 
value). 
XMPMetadata Object Read-only. Camera raw settings for the image. 
(XMPMetadata) 


Note: Valid only for documents opened in 
Camera Raw format. 
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Method Parameter Type Returns What it does 
ChangeMode Changes the color profile. 
(Destinat ionMode Pachangerode 
i objec 
[, Options] ) (BitmapConversionOptions 
or 
IndexedConversionOptions) 
Close Closes the document. When 
( [Saving] ) Ae, EEN) the optional parameter is 
used, the document. 
Default: 3 
(psPromptToSaveChanges). 
ConvertProfile Changes the color profile. 
(DestinationProfile, string 
Intent Eales Note: The 
[, BlackPointCompensation] eee DestinationProfile 
[y Dither) parameter must be 
either a string that 
names the color mode 
or Working RGB, 
Working CMYK, 
Working Gray, Lab 
Color (meaning one 
of the working color 
spaces or Lab color) 
Crop Crops the document. The 
(Bounds o a first parameter is an array of 
[, Angle] ae ee ne, four coordinates that mark 
[, Width] DLR : a 
7 Height] ) UnitValue the portion remaining after 
‘ cropping, in the following 
order: left, top, right, bottom. 
Duplicate Document Creates a duplicate of the 
() Document object. 
ExportDocument Exports the document. 
(ExportiIn File 
[, ExportAs] PsExportType 
D Options] ) ExportOptionsIllustrator 
Flatten Flattens all layers. 
Q 
FlipCanvas Flips the image within the 
(Direction) Eee eager canvas in the specified 
direction. 
ImportAnnotations Imports annotations into the 
(File) SEENI document. 
MergeVisibleLayers Flattens all visible layers in 


() 


the document. 
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Method Parameter Type Returns What it does (Continued) 
Paste ArtLayer Pastes the contents of the 
( [IntoSelection] ) Boolean clipboard into the document. 
If the optional argument is 
set to true and a selection is 
active, the contents are 
pasted into the selection. 
Printout Prints the document. 
( [PostScriptEncoding] PsPrintEncoding 
[, SourceSpace] tit eames Note: PrintSpace specifies 
: rın 
[, PrintSpace] PEM the color space for the 
[, Intent] ——— : : 
[BlackPointCompensation] ) Boolean printer. Valid values 
are nothing (that is, 
the same as the 
source); or Working 
RGB, Working CMYK, 
Working Gray, Lab 
Color (meaning one 
of the working color 
spaces or Lab color); 
or a string specifying a 
specific colorspace. 
Default: nothing). 
RasterizeAllLayers Rasterizes all layers. 
Q) 
ResizeCanvas Changes the size of the 
( [Width] Leena ane canvas to display more or 
,H ioht nı ALUS š 
i E ' Seen re less of the image but does 
á not change the image size. 
See Resizelmage. 
ResizeImage Changes the size of the 
( [Width] UnitValue image. 
[, Height] o a 
[, Resolution] Number (Do e) 
[, ResampleMethod] ) PsResampleMethod 
RevealAll Expands the document to 
() show clipped sections. 
RotateCanvas Rotates the canvas (including 
(Angle) Number (Double) the image) in clockwise 
direction. 
Save Saves the document. 
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Method Parameter Type Returns What it does (Continued) 
SaveAs Saves the document with 
(SaveIn ae specified save options. 
[, Options] object (corresponding 
1 UP SaveOptions object*) 
[, AsCopy] Boolean Note: The options 
[, ExtensionType] ) PsExtensionType parameter’s value can 
be a value from the 
* Examples: 
BMPSaveOptions PsSaveDocumentType 
DCS2_SaveOptions constant list, or any of 
JPEGSaveOptions the “SaveOptions" 
Tirfgavevpt ions objects in the current 
etc. 
chapter such as 
BMPSaveOptions, 
EPSSaveOptions, 
JPEGSaveOptions, and 
so on. 
SplitChannels Array ( — Splits the document 
Document ‘ 
() objects) Channels into separate 
images. 
Trap Applies trapping to a CMYK 
(Width) Number (Long) document. 
Note: Valid only when 
Mode = 3.See Mode. 
Trim Trims the transparent area 
( [Type] Este wmype around the image on the 
Boolean igh > 
[, Top] Baaiean specified sides of the canvas. 
[, Left] 
Boolean 
: ane Boolean Note: Default is true for all 


Boolean values. 


The following script creates a document that contains two images (an eagle and a duck) obtained from the 
Adobe Photoshop CS2 Samples folder and employs the following steps: 


1. Determine which image is larger. 


2. Resize the smaller image to match the larger image. 


3. Create a merged document twice as high as either image in order to hold both images. 


4. Select part of the document and paste the eagle into the selection. T 


5. Invert the selection and paste the duck into the lower part of the document. 


6. Position the eagle over the duck. 


Document.vbs 


Dim appRef, startRulerUnits, startTypeUnits, startDisplayDialogs, eagleDoc 
Dim duckDoc, mergedDoc, selRegion 
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Set appRef = CreateObject ("Photoshop.Application") 


' Save the current preferences 

startRulerUnits = appRef.Preferences.RulerUnits 
startTypeUnits = appRef.Preferences.TypeUnits 
startDisplayDialogs = appRef.DisplayDialogs 


' Set Photoshop CS2 to use pixels and display no dialogs 

appRef .Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels) 

appRef .Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels) 
appRef .DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs) 


' first close all the open documents 

Do While appRef.Documents.Count 
appRef .ActiveDocument .Close 

Loop 


' Open the eagle and duck files from the samples folder 
Set eagleDoc = appRef.Open(appRef.Path + "/Samples/Eagle.psd") 
Set duckDoc = appRef.Open(appRef.Path + "/Samples/Ducky.tif") 


' Find out which document is larger 
' Resize the smaller document the to the larger document's size 
' The resize requires the document be the active/front document 
If (eagleDoc.Width * eagleDoc.Height) > (duckDoc.Width * duckDoc.Height) Then 
appRef .ActiveDocument = duckDoc 
duckDoc.Resize eagleDoc.Width, eagleDoc.Height 
Else 
appRef .ActiveDocument = eagleDoc 
eagleDoc.ResizeImage duckDoc.Width, duckDoc.Height 
End If 


' Create a new document twice as high as two files 
Set mergedDoc = appRef .Documents.Add(duckDoc.Width, duckDoc.Height * 2, 
duckDoc.Resolution, "EagleOverDuck") 


' Copy the eagle to the top; make it the active document so we can manipulate it 
appRef .ActiveDocument = eagleDoc 
eagleDoc.ActiveLayer.Copy 


"Paste the eagle to the merged document, making the merged document active 
appRef .ActiveDocument = mergedDoc 


' Select a square area at the top of the new document 
selRegion = Array(Array(0, 0), _ 
Array (mergedDoc.Width, 0), _ 
Array (mergedDoc.Width, mergedDoc.Height / 2), _ 
Array(0, mergedDoc.Height / 2), _ 
Array(0, 0)) 


' Create the selection 
mergedDoc.Selection.Select (selRegion) 


‘Paste in the eagle 
mergedDoc. Paste 


' do the same thing for the duck 
appRef .ActiveDocument = duckDoc 
duckDoc.ActiveLayer.Copy 
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appRef .ActiveDocument = mergedDoc 
mergedDoc.Selection.Select (selRegion) 


' Inverting the selection so the bottom of the document is now selected 
mergedDoc.Selection.Invert 


' Paste the duck 
mergedDoc. Paste 


' get rid of our originals without modifying them 
duckDoc.Close( 2) 'for PsSaveOptions --> 2 (psDoNotSaveChanges) 
eagleDoc.Close( 2) 


' Reset the application preferences 
appRef.Preferences.RulerUnits = startRulerUnits 
appRef .Preferences.TypeUnits = startTypeUnits 
appRef .DisplayDialogs = startDisplayDialogs 
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Metadata about a Document object. These values can be set by choosing File > File Info in the Adobe 
Photoshop CS2 application. 


Note: You use the object name Info, rather than Document Info, in a script, as in the following sample, 
which sets the Author, Caption, and Copyrighted properties: 


Dim docRef 

docRef = Open(fileList [i] ) 

' set the file info 

docRef.Info.Author = "Mr. Adobe Programmer" 
docRef .Info.Caption = "Adobe photo shoot" 
docRef .Info.Copyrighted = 1 


The following sample uses the DocumentInfo object incorrectly: 


docRef .DocumentInfo.Author = "Mr. Adobe Programmer" 
docRef .DocumentInfo.Caption = "Adobe photo shoot" 
docRef .DocumentInfo.Copyrighted = 1 


Property Value Type What it is 


Application Object (Application) Read-only. The application that the 
collection belongs to. 


Author String Read-write. 

authorPosition String Read-write. 

Caption String Read-write 

CaptionWriter String Read-write. 

Category String Read-write. 

City String Read-write. 

Copyrighted PsCopyrightedType Read-write. The copyrighted status. 

CopyrightNotice String Read-write. 

Country String Read-write. 

CreationDate String Read-write 

Credit String Read-write. 

EXIF Array of arrays: Read-only. Camera data that includes 
oo (tag, tag camera settings used when the image 


was taken. Sample array values are: tag = 
“camera”; tag value = “Cannon”. 


Headline String Read-write. 
Instructions String Read-write. 


JobName String Read-write. 
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Property Value Type What it is (Continued) 

Keywords Array (Strings) Read-write. A list of keywords that can 
identify the document or its contents. 

OwnerUr1 String Read-write. 

Parent Object (Document) Read-only. The Info object's container. 

ProvinceState String Read-write. 

Source String Read-write. 

SupplementalCategories Array (Strings) Read-write. 

Title String Read-write. 

TransmissionReference String Read-write. 

typename String Read-only. The class name of the 
referenced Info object. 

Urgency PsUrgency Read-write. 


The following script checks to see if any documents are open. If none are open, it opens the sample file 


eagle.psd 


The script then sets the following document info (metadata): 


e Author: Mr. Adobe programmer 


e Caption: Adobe Photo shoot 


e CaptionWriter: Mr. Adobe programmer 


e City: San Jose 


e CopyrightNotice: Copyright (c) Adobe Programmer Photography 


e Copyrighted status: Copyrighted Work 


e Country: USA 
e State:CA 


Note: After the script finishes running, choose File > File Info to display the metadata set by the script. 


DocumentInfo.vbs 


Dim appRef, startRulerUnits, 


startTypeUnits, 


startDisplayDialogs, docRef 


Set appRef = CreateObject ("Photoshop.Application") 


' Save the current preferences 


startRulerUnits = appRef.Preferences.RulerUnits 
startTypeUnits = appRef.Preferences.TypeUnits 


startDisplayDialogs = appRef.DisplayDialogs 


' Set Photoshop CS2 to use pixels and display no dialogs 
appRef .Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels) 
appRef .Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels) 
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appRef .DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs) 


' if there are no documents open then try to open a sample file 
If appRef.Documents.Count = 0 Then 

appRef .Open(appRef.Path + "/Samples/Eagle.psd") 
End If 


Set docRef = appRef .ActiveDocument 


' tag all of the documents with photo shoot information 

docRef.Info.Author = "Mr. Adobe Programmer" 

docRef .Info.Caption = "Adobe Photo shoot" 

docRef .Info.captionWriter = "Mr. Adobe Programmer" 

docRef.Info.city = "San Jose" 

docRef .Info.CopyrightNotice = "Copyright (c) Adobe Programmer Photography" 
docRef .Info.Copyrighted = 1 'for PsCopyrightedType --> 1 (psCopyrightedWork) 
docRef.Info.country = "USA" 

docRef .Info.provinceState = "CA" 


' Reset the application preferences 

appRef .DisplayDialogs = startDisplayDialogs 
appRef .Preferences.RulerUnits = startRulerUnits 
appRef .Preferences.TypeUnits = startTypeUnits 
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Note: See ‘Document’ on page 51 for information on the Document object. 


Property Value Type What it is 
Application Object Read-only. The application that the collection belongs 
(Application) 
r to. 
Count Number (Long) Read-only. The number of elements in the Documents 
collection. 
Item Read-only. Gets an element from the collection. 
Object (Document) 
Parent Object Read-only. The Documents objects’ container. 
(Application) 
typename String Read-only. The class name of the referenced Documents 
object. 
Method Parameter Type Returns What it does 
Add Document Adds a Document Object 
( [Width] UnitValue (PixelAspectRatio: 0.100 0 10.00). 
[, Height] UnitValue 
[, Resolution] Number (Double) 
[, Name] String 
[, Mode] PsNewDocumentMode 
[, InitialFil1] PsDocument Fill 
[PixelAspectRatio] ) Number (Double) 
Index object (Document ) umor Gets an element from the Documents 
(ItemPtr) (rongi collection. 
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Options that can be specified when opening an EPS format document. 


Property Value Type What it is 
AntiAlias Boolean Read-write. Indication of whether to use 
antialias. 
Application Object Read-only. The application that the collection 
(Application) 
———— belongs to. 
ConstrainProportions Boolean Read-write. Indication of whether to constrain 


the proportions of the image. 


Height Number (Double) Read-write. The height of the image (unit 
value). 
Mode PsOpenDocumentMode Read-write. The color profile to use as the 


document mode. 


Resolution Number (Double) Read-write. The resolution of the document in 
pixels per inch. 


typename String Read-only. The class name of the referenced 
EPSOpenOpt ions object. 


Width Number (Double) Read-write. The width of the image (unit value). 
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Options that can be specified when saving a document in EPS format. 


Property Value Type What it is 
Application Object Read-only. The application that the collection 
(Application) 
belongs to. 
EmbedColorProfile Boolean Read-write. Indication of whether to embed the color 
profile in this document. 
Encoding PsSaveEncoding Read-write. The type of encoding to use. Default: 1. 
HalftoneScreen Boolean Read-write. Indication of whether to include the 
halftone screen. Default: false. 
Interpolation Boolean Read-write. Indication of whether to use image 
interpolation. Default: false. 
Preview PsPreviewType Read-write. The preview type. 
PsColorManagement Boolean Read-write. Indication of whether to use Postscript 
color management. Default: false. 
TransferFunction Boolean Read-write. Indication of whether to include the 
Transfer functions to compensate for dot gain 
between the image and film. Default: false. 
TransParentWhites Boolean Read-write. Indication of whether to display white 
areas as transParent. 
Note: Valid only when Document.Mode = 5. See 
‘Mode’ on page 52 (in the Properties table of 
the Document object) or ‘ChangeMode’ on 
page 53 (in the Methods table of the Document 
object). 
typename String Read-only. The class name of the referenced 
EPSSaveOptions object. 
VectorData Boolean Read-write. Indication of whether to include vector 


data. 


Note: Valid only if the document includes vector 
data (text). 
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Options that can be specified when exporting a Pathltem object to an Adobe Illustrator’ file. 


Property Value Type What it is 

Application Object (Application) Read-only. The application that the 
collection belongs to. 

Path PsIllustratorPathType |Read-write. The type of path to export. 
Default: 1. 

PathName String Read-write. The name of the path to export. 
Note: Valid only when Path = 3.See Path. 

typename String Read-only. The class name of the referenced 


ExportOptionsTIllustrator object. 
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Options that can be specified when optimizing a document for the Web. 


Property Value type What it is 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

Blur Number (Double) Read-write. Applies blur to the image to reduce 


artifacts. Default: o . o. 


ColorReduction PsColorReductionType Read-write. The color reduction algorithm. 
Default: 1 (psSelective). 


Colors Number (Long) Read-write. The number of colors in the palette. 
Default: 256. 

Dither PsDitherType Read-write. The type of dither. Default: 2 
(psDiffusion). 

DitherAmount Number (Long) Read-write. The amount of dither. Default: 100. 


Note: Valid only when Dither = 2. See Dither. 


Format PsSaveDocument Type Read-write. The file format to use. Default: 3 
(psCompuServeGIFSave). 


IncludeProfile Boolean Read-write. Indication of whether to include the 
document's embedded color profile. Default: 
false. 

Interlaced Boolean Read-write. Indication of whether to download in 


multiple passes; progressive. Default: false. 


Lossy Number (Long) Read-write. The amount of lossiness allowed. 
Default: o. 

MatteColor RGBColor Read-write. The colors to blend transParent pixels 
against. 

Optimized Boolean Read-write. Indication of whether to create smaller 


but less compatible files. Default: true. 


Note: Valid only when format = 6 
(pSJPEGSave). See Format. 


PNG8 Boolean Read-write. Indicates the number of bits; true = 8, 
false = 24. Default: true. 


Note: Valid only when format = 13 
(psPNGSave). See Format. 


Quality Number (Long) Read-write. The quality of the produced image (0 - 
100 as percentage; default: 60). 
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Property Value type What it is (Continued) 
Transparency Boolean Read-write. Indication of transParent areas of the 


image should be included in the saved image. 
Default: true. 


TransparencyAmount Number (Long) Read-write. The amount of transparency dither. 
Default: 100. 


Note: Valid only if Transparency = true. See 
Transparency. 


TransparencyDither PsDitherType Read-write. The transparency dither algorithm. 
Default: 1. 
typename String Read-only. The class name of the referenced 


ExportOptionsSaveForwWeb object. 


WebSnap Number (Long) Read-write. The tolerance amount within which to 
snap close colors to Web palette colors. Default: o. 
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Options that define the BannerOptions property of the GalleryOptions object. See ‘GalleryOptions’ on 
page 71. 


Tip: You can preserve default values for many GalleryBannerOptions properties by setting the 
GalleryOptions property PreserveAl1Metadata to true or by choosing File > Automate > Web 
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo 


Gallery dialog. 

Property Value Type What it is 

Application Object (Application) Read-only. The application that the 
collection belongs to. 

ContactInfo String Read-write. The Web photo gallery 
contact info. 

Date String Read-write. The Web photo gallery date. 
Default: current date. 

Font PsGalleryFontType Read-write. The font setting for the 
banner text. Default: 1. 

FontSize Number (Long) Read-write. The font size for the banner 
text (1 - 7; default: 3). 

Photographer String Read-write. The Web photo gallery 
photographer. 

SiteName String Read-write. The Web photo gallery site 
name. Default: 
Adobe Web Photo Gallery. 

typename String Read-only. The class name of the 


referenced GalleryBannerOptions 
object. 
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Options that define the customColorOptions property of the GalleryOptions object. See 


‘GalleryOptions’ on page 71. 


Tip: You can preserve default values for many GalleryCustomColorOptions properties by setting the 
GalleryOptions property PreserveAl1Metadata to true or by choosing File > Automate > Web 
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo 


Gallery dialog. 

Property Value Type What it is 

ActiveLinkColor Object (RGBColor) Read-write. The color to use to indicate 
an active link. 

Application Object (Application) Read-only. The application that the 
collection belongs to. 

BackgroundColor Object (RGBColor) Read-write. The background color. 

BannerColor Object (RGBColor) Read-write. The banner color. 

LinkColor Object (RGBColor) Read-write. The color to use to indicate a 
link. 

TextColor Object (RGBColor) Read-write. The text color. 

typename String Read-only. The class name of the 
referenced 
GalleryCustomColorOptions object. 

VisitedLinkColor Object (RGBColor) Read-write. The color to use to indicate a 


visited link. 
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Options that define the ImagesOptions property of the GalleryOptions object. See ‘GalleryOptions’ on 


page 71. 


Tip: You can preserve default values for many GalleryImagesOptions properties by setting the 
GalleryOptions property PreserveAl1Metadata to true or by choosing File > Automate > Web 
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo 


Gallery dialog. 
Property Value Type What it is 
Application Object (Application) Read-only. The application that the collection 
belongs to. 
Border Number (Long) Read-write. The size (in pixels) of the border 
that separates images (0 - 99; default: o). 
Caption Boolean Read-write. Indication of whether to generate 
image captions. Default: false. 
Dimension Number (Long) Read-write. The resized image dimensions in 
pixels. Default: 350. 
Note: Valid only when ResizeImages = 
true. See Resizelmages. 
Font PsGalleryFont Type Read-write. The font to use for image 
captions. Default: 1. 
FontSize Number (Long) Read-write. The font size for image captions 
(1 - 7; default: 3). 
Note: Valid only when caption = true. See 
Caption. 
ImageQuality Number (Long) Read-write. The quality setting for a JPEG 
image (0 - 12; default: 5). 
IncludeCopyright Boolean Read-write. Indication of whether to include 
copyright information in captions. Default: 
false. 
Note: Valid only when caption = true. See 
Caption. 
IncludeCredits Boolean Read-write. Indication of whether to include 


the credits in image captions. Default: false. 


Note: Valid only when caption = true. See 
Caption. 
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Property 


Value Type 


What it is (Continued) 


IncludeFilename 


IncludeTitle 


NumericLinks 


ResizeConstraint 


ResizeImages 


typename 


Boolean 


Boolean 


Boolean 


PsGalleryConstrainType 


Boolean 


String 


Read-write. Indication of whether to include 
the file name in image captions. Default: 


true. 


Note: Valid only when caption = true. See 
Caption. 


Read-write. Indication of whether to include 
the title in image captions. Default: false. 


Note: Valid only when caption = true. See 
Caption. 


Read-write. Indication of whether to add 
numeric links. Default: true. 


Read-write. The image dimensions to 
constrain in the gallery image. Default: 3. 


Note: Valid only when ResizeImages = 
true. See Resizelmages. 


Read-write. Indication of whether to 
automatically resize images for placement on 
the gallery pages. Default: true. 


Read-only. The class name of the referenced 
GalleryImagesOptions object. 
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Tip: You can preserve default values for many GalleryOptions properties by choosing File > Automate 
> Web Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web 


Photo Gallery dialog. 


Property 


AddSizeAttributes 


Application 


BannerOptions 


CustomColorOptions 


EmailAddress 


ImagesOptions 


IncludeSubFolders 


LayoutStyle 


PreserveAllMetadata 


SecurityOptions 


ThumbnailOptions 


typename 


Value Type 


Boolean 


Object (Application) 


Object (GalleryBannerOptions) 


Object (GalleryCustomColorOptions) 
String 
Object 


(GalleryImagesOptions) 


Boolean 


String 


Boolean 


Object (GallerySecurityOptions) 


Object (GalleryThumbnailOptions) 


String 


What it is 


Read-write. Indicates whether width 
and height attributes for images will be 
added. Default: true. 


Read-only. The application that the 
collection belongs to. 


Read-write. The options related to 
banner settings. 


Read-write. The options related to 
custom color settings. 


Read-write. The email address to show 
on the Web page. 


Read-write. The options related to 
images settings. 


Read-write. Indication of whether to 
include all files found in sub folders of 
the input folder. Default: true. 


Read-write. The style to use for laying 
out the Web page. Default: centered 
Frame 1 - Basic. 


Read-write. Indicates whether to save 
metadata. Default: false. 


Read-write. The options related to 
security settings. 


Read-write. The options related to 
thumbnail image settings. 


Read-only. The class name of the 
referenced GalleryOptions object. 
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Property 


Value Type 


What it is (Continued) 


UseShortExtension 


UseUTF8Encoding 


Boolean 


Boolean 


Read-write. Indicates whether the 
short Web page extension .htm or 
Number (Long) Web page extension 
.htm1 will be used. Default: true. 


Read-write. Indicates whether the Web 
page should use UTF-8 encoding. 
Default: false. 
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Options that define the SecurityOptions property of the GalleryOptions object. See ‘GalleryOptions’ 


on page 71. 


Tip: You can preserve default values for many GallerySecurityOptions properties by setting the 
GalleryOptions property PreserveAl1Metadata to true or by choosing File > Automate > Web 
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo 


Gallery dialog. 

Property Value Type What it is 

Application Object (Application) Read-only. The application that the 
collection belongs to. 

Content PsGallerySecurityType Read-write. The Web photo gallery 
security content. Default: 1. 

Font PsGalleryFontType Read-write. The Web photo gallery 
security font. Default: 1. 

FontSize Number (Long) Read-write. The Web photo gallery 
security font size (1 - 72; default: 3). 

Opacity Number (Long) Read-write. The Web page security 
opacity as a percent. Default: 100. 

Text String Read-write. The Web photo gallery 
security custom text. 

TextColor Object (RGBColor) Read-write. The Web page security text 
color. 

TextPosition PsGallerySecurityTextPositionTyp Read-write. The Web photo gallery 

S security text position. Default: 1. 

TextRotate PsGallerySecurityTextRotateType Read-write. The Web photo gallery 
security text orientation to use. Default: 
1. 

typename String Read-only. The class name of the 


referenced GallerySecurityOptions 
object. 
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Options that define the thumbnailoptions property of the GalleryOptions object. See ‘GalleryOptions’ 


on page 71. 


Tip: You can preserve default values for many GalleryThumbnailOptions properties by setting the 
GalleryOptions property PreserveAl1Metadata to true or by choosing File > Automate > Web 
Photo Gallery, and then choosing Preserve all metadata on the Options area of the Web Photo 


Gallery dialog. 

Property Value Type What it is 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

Border Number (Long) Read-write. The amount of border pixels you 
want around your thumbnail images (0 - 99; 
default: 0). 

Caption Boolean Read-write. Indicates whether there is a 
caption. Default: false. 

ColumnCount Number (Long) Read-write. The number of columns on the 
page. Default: 5. 

Dimension Number (Long) Read-write. The Web photo gallery thumbnail 
dimension in pixels. Default: 75 . 

Font PsGalleryFontType Read-write. The Web photo gallery font. 
Default: 1. 

FontSize Number (Long) Read-write. The font size for thumbnail 
images text (1 - 7; default: 3). 

IncludeCopyright Boolean Read-write. Indication of whether to include 
copyright information for thumbnails. 
Default: false. 

IncludeCredits Boolean Read-write. Indication of whether to include 
credits for thumbnails. Default: false. 

IncludeFilename Boolean Read-write. Indication of whether to include 
file names for thumbnails. Default: false. 

IncludeTitle Boolean Read-write. Indication of whether to include 
titles for thumbnails. Default: false. 

RowCount Number (Long) Read-write. The number of rows on the page. 
Default: 3. 

Size PsGalleryThumbSizeType Read-write. The thumbnail image size. 
Default: 2. 

typename String Read-only. The class name of the referenced 


GalleryThumbnailOptions object. 
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Options that can be specified when saving a document in GIF format. 


Property Value Type What it is 
Application Object Read-only. The application that the collection 
(Application) 
belongs to. 

Colors Number (Long) Read-write. The number of palette colors. 

Note: Valid only when Palette = 2;Palette = 
3; Palette = 4; Palette = 5;Palette = 
6; Palette = 7;Or Palette = 8.See 
Palette. 

Dither PsDitherType Read-write. The dither type. 

DitherAmount Number (Long) Read-write. The amount of dither. (1 - 100; 
default: 75). 

Note: Valid only for when Dither = 2.See 
Dither. 

Forced PsForcedColors Read-write. The type of colors to force into the 
color Palette. 

Interlaced Boolean Read-write. Indicates whether rows should be 
interlaced. Default: false. 

Matte PsMatteType Read-write. The color to use to fill antialiased 
edges adjacent to transParent areas of the image. 
Default: 4. 

Note: When Transparency = false, the matte 
color is applied to transParent areas. See 
Transparency. 

Palette PsPaletteType Read-write. The type of palette to use. Default: 
Palette.7. 

PreserveExactColors Boolean Read-write. Indication of whether to protect 
colors in the image that contain entries in the 
color table from being dithered. 

Note: Valid only when Dither = 2. See Dither. 

Transparency Boolean Read-write. Indication of whether to preserve 
transParent areas of the image during conversion 
to GIF format. 

typename String Read-only. The class name of the referenced 


GIFSaveOptions object. 
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Property Value Type What it is 

Application Object Read-only. The application that the collection belongs 
(Application) to 

Gray Number (Double) Read-write. The gray value (0.0 - 100.0; default: 0.0). 

typename String Read-only. The class name of the referenced grayColor 


object. 
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A version of the document stored automatically (and added to the HistoryStates collection), which 
preserves the document's state, each time the document is saved. 


Note: See ‘HistoryStates’ on page 116 for information about the HistoryStates collection. 


Property Value Type What it is 

Application C a Read-only. The application that the collection belongs to. 
Name String Read-only. The Historystate object's name. 

Parent Object (Document) Read-only. The Historystate object's container. 
Snapshot Boolean Read-only. Indicates whether the history state is a snapshot. 
typename String Read-only. The class name of the referenced HistoryState 


object. 
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The collection of HistoryState objects in the document. 


Note: See ‘HistoryState’ on page 77 for more information on HistoryState objects. 


Property Value Type What it is 
Application Object (Application) Read-only. The application that the collection belongs to. 
Count Number (Long) Read-only. The number of elements in the HistoryStates 
collection. 
Item Read-only. Gets an element from the collection. 
Object 
(HistoryState) 
Parent Object (Document) Read-only. The HistoryStates object's container. 
typename String Read-only. The class name of the referenced 
HistoryStates object. 
Method Parameter Type Returns What it does 
Index Number (Long) Gets an element from the 
(ItemPtr) Object HistoryStates collection. 


(HistoryState) 
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Options that can be specified for a color object using the HSB color model. 


Property Value Type What it is 

Application oo cas Read-only. The application that the collection belongs to. 
Brightness Number (Double) Read-write. The brightness value (0.0 - 100.0). 

Hue Number (Double) | Read-write. The hue value (0.0 - 100.0). 

Saturation Number (Double) Read-write. The saturation value (0.0 - 100.0). 

typename String Read-only. The class name of the referenced HSBColor object. 
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Options that can be specified when converting an RGB image to an indexed color model. 


Property Value Type What it is 
Application Object Read-only. The application that the collection 
(Application) 
belongs to. 
Colors Number (Long) Read-write. The number of palette colors. 
Note: Valid only when Palette = 2; Palette = 
3; Palette = 4;Palette = 5;Palette = 
6; Palette = 7;Of Palette = 8.See 
Palette. 
Dither PsDitherType Read-write. The dither type. 
DitherAmount Number (Long) Read-write. The amount of dither. (1 - 100). 
Note: Valid only when Dither = 2. 
Forced PsForcedColors Read-write. The type of colors to force into the 
color palette. 
Matte PsMatteType Read-write. Read-write. The color to use to fill 
antialiased edges adjacent to transParent areas of 
the image. Default: 4. 
Note: When Transparency = false, the matte 
color is applied to transParent areas. See 
Transparency. 
Palette PsPaletteType Read-write. The palette type. Default: 1. 
PreserveExactColors Boolean Read-write.Indication of whether to protect colors 
in the image that contain entries in the color table 
from being dithered. 
Note: Valid only when Dither = 2. See Dither. 
Transparency Boolean Read-write. Indication of whether to preserve 
transParent areas of the image during conversion 
to GIF format. 
typename String Read-only. The class name of the referenced 


IndexedConversionOptions object. 
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Options that can be specified when saving a document in JPEG format. 


Property Value Type What it is 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

EmbedColorProfile Boolean Read-write. Indication of whether to embed the color 


profile in the document. 


FormatOptions PsFormatOptionsType Read-write.The download format to use. Default: 1. 


Matte PsMatteType Read-write. The color to use to fill antialiased edges 
adjacent to transParent areas of the image. Default: 4. 


Note: When Transparency = false, the matte color 
is applied to transParent areas. See 


Transparency. 


Quality Number (Long) Read-write. The image quality setting to use (affects 
file size and compression) (0 - 12; default: 3). 


Scans Number (Long) Read-write. The number of scans to make to 
incrementally display the image on the page 
(3 - 5; default: 3). 


Note: Valid only for when FormatOptions = 3. 


typename String Read-only. The class name of the referenced 
JPEGSaveOptions object. 
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Options that can be specified when defining a color object using the LAB color model. 


Property Value Type What it is 

A Number (Double) Read-write. The a-value (-128.0 - 127.0). 

Application oe Read-only. The application that the collection belongs to. 
B Number (Double) Read-write. The b-value (-128.0 - 127.0). 

L Number (Double) Read-write. The L-value (0.0 - 100.0). 

typename String Read-only. The class name of the referenced LabCcolor 


object. 
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A snapshot of a state of the layers in a document (can be used to view different page layouts or 


compositions). 


Property Value Type What it is 
Appearance Boolean Read-write. Indication of whether to use 
layer appearance (layer styles) settings. 
Application Object (Application) Read-only. The application that the 
collection belongs to. 
Comment String Read-write. A description of the layer 
comp. 
Name String Read-write. The name of the layer comp. 
Parent Object (Document) Read-write. The LayerCcomp object's 
container. 
Position Boolean Read-write. Indication of whether to use 
layer position. 
Selected Boolean Read-only. Indication of whether the 
layer comp is currently selected. 
typename String Read-only. The class name of the 
referenced LayerComp object. 
Visibility Boolean Read-write. Indication of whether to use 
layer visibility settings. 
Method Parameter Type Returns What it does 
Apply Applies the layer comp to the document. 
() 
Recapture Recaptures the current layer state(s) for 
() this layer comp. 
Remove Deletes the LayerComp object. 
() 
Reset fromComp Resets the layer comp state to the 


() 


document state. 
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Note: See ‘LayerComp’ on page 121 for information on LayerComp objects. 


Property Value Type What it is 
Application Object (Application) Read-only. The application that the collection belongs 
to. 
Count Number (Long) Read-only. The number of elements in the LayerComps 
collection. 
Item Object (LayerComp) Read-only. Gets an element from the collection. 
Parent Object (Document) Read-only. The Layercomps object's container. 
typename String Read-only. The class name of the referenced 
LayerComps object. 
Method Parameter Type Returns What it does 
Add LayerComp Adds a layer comp. 
(Name, String 
Comment, ee 
Appearance, sre 
Position, Boolean 
Visibility) Boolean 
Index Number (Long) Gets an element from the 
(ItemPtr) Object (LayerComp) LayerComps collection. 
RemoveAll 


() 


Removes all LayerComp objects from 
the LayerComps collection. 
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The collection of layer objects, including ArtLayer and LayerSet objects, in the document. 


Note: See ‘ArtLayer’ on page 56 for information on artLayer objects. See ‘LayerSet’ on page 124 for 


information on LayerSet objects. 


Property Value Type What it is 
Application Object Read-only. The application that the collection belongs to. 
(Application) 
Count Number (Long) Read-only. The number of elements in the Layers 
collection. 
Item Read-only. Gets an element from the collection. 
Object (Layer) 
Parent Object (Document Read-only. The Layers object's container. 
or LayerSet 
typename String Read-only. The class name of the referenced Layers object. 
Method Parameter Type Returns What it does 
Index Number (Long) Gets an element from the collection. 
Object 
(Application) 
RemoveAll 


() 


Removes all layers from the collection. 
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A group of layer objects, which can include art Layer objects and other (nested) LayerSet objects. A 
single command or set of commands manipulates all layers ina LayerSet object. 


Property Value Type What it is 


AllLocked Boolean Read-write. Indicates whether the contents in the layers 
contained in the LayerSet object are editable. 


Application Object | Read-only. The application that the collection belongs to. 
(Application) 
ArtLayer Object (ArtLayer) Read-only. When LayerType = 1 (psArtLayer), this 


property returns a reference to the corresponding 
LayerSet object. See LayerType. 


ArtLayers Object (ArtLayers) Read-only. The ArtLayers in this LayerSet. 

BlendMode PsBlendMode Read-write. The blend mode to use for the layer set. 
Bounds Array (UnitValue) Read-only. The bounding rectangle of the layer set. 
EnabledChannels Pee Read-write. The channels enabled for the layer set; must be 


a list of component channels. 


Note: See kina in the Properties table for the Channel 
Object (‘Channel’ on page 40). 


Layer Object (layer) Read-only. The layer corresponding to the Layer Set. 
Layers Object (Layers) Read-only. The layers in this Layerset object. 
LayerSet Object (LayerSet) Read-only. When LayerType = 2 (psLayerSet), this 


property returns a reference to the corresponding 
LayerSet object. See LayerType. 


LayerSets Object (LayerSets) Read-only. The top level LayerSets in this document. 

LayerType PsLayerType Read-only. The type of layer. 

LinkedLayers Array (layers) Read-only. The layers linked to this LayerSet object. 

Name String Read-write. The name of the LayerSet object. 

Opacity Number (Double) Read-write. The master opacity of the Layerset Object (0.0 
- 100.0). 

Parent Object (Document or Read-only. The LayerSet object's container. 

LayerSet 

typename String Read-only. The class name of the referenced LayerSet 
object. 

Visible Boolean Read-write. Indicates whether the LayerSet object is 


visible. 
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Method Parameter Type Returns What it does 
yp 
Duplicate Object (Layer) Creates a duplicate of the 
( [RelativeObject] obier. voneet LayerSet object. 
[, InsertionLocation] } PsElementPlacement 
Link Links the layer set with another 
Object 
0) (Application) layer. 
Merge ArtLayer Merges the layerset; returns a 
() reference to the art layer created 
by this method. 
Move Moves the LayerSet object. 
: Object 
(RelativeObj ect, (Application) 
Insert ionLocation) PsElement Placement 
Remove Deletes the LayerSet object. 
() 
Resize Resizes all layers in the layer set 
( [Horizontal] sae Ee to the specified dimensions (as a 
, Vert : 1 umoer O e : ° 
l lari e ] heharnortontt tak percentage of its current size) 
i and places the layer set in the 
specified position. 
Rotate Rotates all layers in the layer set 
(Angle anew ones around the specified anchor 
L, Anchor] ) S cnorPosition point. 
Translate Moves the position relative to its 
( [Delt ax] UnitValue current position. 
[, Deltay] ) UnitValue 
Unlink Unlinks the layer set. 


() 
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The collection of LayerSet objects in the document. 


Note: See ‘LayerSet’ on page 124 for information on LayerSet objects. 


Property Value Type What it is 
Application Object Read-only. The application that the collection belongs to. 
(Application) 
Count Number (Long) Read-only. The number of elements in the LayerSets 
collection. 
Item Read-only. Gets an element from the collection. 
Object (LayerSet) 
Parent Object (Document Read-only. The LayerSets object's container. 
or LayerSet 
typename String Read-only. The class name of the referenced LayerSets 
object. 
Method Parameter Type Returns What it does 
Add LayerSet Creates a new LayerSet object. 
() 
Index Number (Long) Gets an element from the LayerSets 
(ItempTR) Object (LayerSet) collection. 
RemoveAll Removes the layer set, and any layers or 


() layer sets it contains, from the document. 


The following script creates three layer sets, then nests a second layer set in each layer set, and then 
creates a text layer in each nested set that displays the text “Layer in n Set Inside n Set”, where n represents 
the ordinal number of the set (first, second, or third). 


LayerSets.vbs 
Dim appRef, docRef, myLayerSets(3,3), textArray, i, myLayers (3) 


Set appRef = CreateObject ("Photoshop.Application") 


‘close all open documents 

Do While appRef.Documents.Count 
appRef .ActiveDocument .Close 

Loop 


' create a working document 
Set docRef = appRef.Documents.Add 
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' Create an array to hold the text 
textArray = Array("First", "Second", "Third") 


'Create an indexer variable 
i=0 


' Create three layer sets at the top level 
for i = 0 to 2 

Set myLayerSets(i,0) = docRef.LayerSets.Add 
Next 


' Rearrange the layer sets with the first one on top, second next, etc. 
myLayerSets (1,0) .moveAfter (myLayerSets (0,0) ) 
myLayerSets (2,0) .moveAfter (myLayerSets (1,0) ) 


' Create a layer set inside each layer set 
for i = 0 to 2 
myLayerSets(i,0) .Name = textArray(i) + " Set" 
Set myLayerSets(i,1) = myLayerSets(i,0) .LayerSets.Add 
myLayerSets(i,1).Name = "Inside " + textArray(i) + " Set" 
Next 


' Create a text layer with a description inside each layer set 
LOY a, S90- tON2 

Set myLayers(i) = myLayerSets(i,1) .ArtLayers.Add 

myLayers(i).Kind = 2 ' PsLayerKind.psTextLayer 

myLayers(i).textItem.Contents = "Layer in " & textArray(i) & " Set Inside " _ 
& textArray(i) & " Set" 
myLayers(i).textItem.position = Array (appRef.ActiveDocument.Width * i * 0.33, 
appRef .ActiveDocument.Height * (i +1) * 0.25) 


myLayers(i).textItem.Size = 12 
Next 
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Defines the optional parameter of the Art Layer object’s Appl yLensBlur () method. 


Note: See ApplyLensB1lur (in the Methods table of the ArtLayer object). 


Property Value type What it is 

Amount Number (Long) Read-write. The amount of noise. Default: o. 

Application Object (Application) Read-only. The application that the collection belongs 
to. 

BladeCurvature Number (Long) Read-write. The blade curvature of the iris. Default: o. 

Brightness Number (Long) Read-write. The brightness for the specular highlights. 
Default: o. 

Distribution PsNoiseDistribution Read-write. The distribution value for the noise. 
Default: 1 (psUniformNoise). 

FocalDistance Number (Long) Read-write. The blur focal distance for the depth map. 
Default: o. 

InvertDepthMap Boolean Read-write. Indicates whether the depth map is 
inverted. Default: false. 

Monochromatic Boolean Read-write. Indicates whether the noise is 
monochromatic. Default: false. 

Radius Number (Long) Read-write. The radius of the iris. Default: 15. 

Rotation Number (Long) Read-write. The rotation of the iris. Default: o. 

Shape PsGeometry The shape of the iris. Default: 2. (psHexagon). 

Source PsDepthMapSource Read-write. The source for the depth map. Default: 1 
(psNoSource). 

Threshold Number (Long) Read-write. The threshold for the specular highlights. 
Default: o. 

typename String Read-only. The class name of the referenced 


lensBlurOptions object. 
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An object that represents a missing color. 


Property Value type What it is 


Application Object (Application) Read-only. The application that the collection belongs to. 


typename String Read-only. The class name of the referenced noColor 


object. 
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An event-handler object that tells the script to execute specified code when a specified event occurs. 


Property Value type What it is 
Application Object Read-only. The application that the collection belongs to. 
(Application) 
Event String Read-only. The event ID in four characters or a unique String 
that the notifier is associated with. 
EventClass String Read-only. The class ID of the event associated with the 
Notifier object, four characters or a unique string. 
Note: Fora list of four-character codes, see Appendix A: 
Event ID Codes. 
EventFile File Read-only. The path to the file to execute when the event 
occurs/activates the notifier. 
Parent Object Read-only. The Notifier object’s container. 
(Application) 
typename String Read-only. The class name of the referenced Notifier 
object. 
Method Parameter type Returns What it does 
Remove 


0) 


Deletes the Notifier object. 


Note: You can remove a Notifier object 
from the Script Events Manager 
drop-down list by deleting the file 
named Script Events 
Manager .xm1 from in the 
Photoshop preferences folder. See 
Adobe Photoshop CS2 help for 
more information. 
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The collection of Notifier objects in the document; the Not ifiers property of the Application object. 


Note: See ‘Notifier’ on page 92 for information on Notifier objects. See Notifiers (in the Properties table 
of the Application object). 


Property Value type What it is 

Application Object | Read-only. The application that the collection belongs to. 
(Application) 

Count Number (Long) Read-only. The number of elements in the Notifiers 

collection. 

EventClass String Read-only. The class ID of the event. 

Item Read-only. Gets an element from the collection. 
Object 
(Notifier) 

Parent Object Read-only. The Notifiers object's container 
(Application) 

typename String Read-only. Read-only. The class name of the referenced 


Notifiers object. 
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Method Parameter type Returns What it does 
Add Notifier Creates a Notifier object. 
(Event, String 
file 


EventFile Note: EventClass defines the class ID 

[, EventClass] ) of the event: four characters ora 
unique string . For a list of 
four-character codes, see 
Appendix A: Event ID Codes. 


Tip: Remember to omit the single 
quotes when including a 
four-character ID in your code. 


Note: An EventClass value 
corresponds to the value you 
would type in the Descriptive 
Lable box when adding an 
event in the Script Events 
Manager in the Adobe 
Photoshop CS2 application. For 
more information on using the 
Script Events Manager, please 
refer to Adobe Photoshop CS2 


help. 
Index Number (Long) Gets an element from the Notifiers 
(ItemPtr) Object (Notifier) collection. 
RemoveAll Removes all Notifier objects from 


() the Notifiers collection. 


Note: You can remove a notifier 
object from the Script Events 
Manager drop-down list by 
deleting the file named script 
Events Manager.xml fromin 
the Photoshop preferences 
folder. See Adobe Photoshop 
CS2 help for more information. 


VBScript Scripting Reference 


Adobe Photoshop CS2 


VBScript Interface 95 


A path or drawing object, such as the outline of a shape or a straight or curved line, which contains sub 
paths that comprise its geometry. 


Property Value Type What it is 
Application Object Read-only. The application that the collection 
(Application) 
E belongs to. 
Kind PsPathKind Read-write. The PathItem object's type. 
Name String Read-write. The PathItem object's name. 
Parent Object Read-only. The PathItem object's container. 
(Document ) 
SubPathItems Object Read-only. The sub path objects for this PathItem 
(SubPathItems) i 
eres object: 
typename String Read-only. The class name of the referenced 
PathItem object. 
Method Parameter Type Returns What it does 
Delete Deletes this PathItem 
() object. 
Deselect Deselects this PathItem 
O object. 
Duplicate Duplicates this PathItem 
(Name) String object with the new name 
specified in the argument. 
FillPath Fills the area enclosed by 
i Object (SolidColor, tee A E 
([Fil1Color] E + or the path (Opacity: 0 - 100 
[, Mode] String H as percent; Feather: 0.0 - 
[, Opacity] PsColorBlendMode 250.0 in pixels). 
[, PreserveTransparency] Number (Double) 
[, Feather] Boolean 
[, WholePath] Number (Double) 
[, AntiAlias] ) Boolean 
Boolean 
MakeClippingPath Number (Double) Makes this PathItem 
([Flatness] ) object the clipping path 


for this document; the 
optional parameter tells 
the PostScript printer how 
to approximate curves in 
the path (0.2 - 100). 
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Method Parameter Type Returns What it does (Continued) 
MakeSelection Makes a Selection 
( [Feather] ae (Double) object, whose border is 
i . oolean $ 
: ene : Pesel ect iT the path, from this 
7» UP PathItem Object 
(Feather: 0.0 - 250.0 in 
pixels). 
Note: See ‘Selection’ on 
page 123. 
Select Makes this PathItem 
() object the active or 
selected PathItem object. 
StrokePath Strokes the path with the 
( [Tool] Baise te specified information. 
[, SimulatePressure] ) Boolean 


The following creates a path in three segments: two diagonal lines that form a V, and a curved line above 
the V that makes it look like a 2D ice cream cone. 


Paths.vbs 


Dim appRef, startRulerUnits, 
Dim lineArray (2), 


Set appRef = 


lineArray2 (2), 


CreateObject ("Photoshop.Application") 


' Save the current preferences 


startRulerUnits = appRef.Preferences.RulerUnits 
appRef .Preferences.TypeUnits 
appRef .DisplayDialogs 


startTypeUnits 
startDisplayDialogs 


startTypeUnits, 


' Set Photoshop CS2 to use pixels and display no dialogs 


appRef.Preferences.RulerUnits = 1 'for PsUnits --> 1 
appRef .Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 
appRef .DisplayDialogs = 3 


' first close all the open documents 
Do While appRef .Documents.Count 
appRef .ActiveDocument .Close 


Loop 


' create a document to work with 


Set docRef = 


‘line #1--it’s a straight line so the coordinates for anchor, 
'right for each point have the same coordinates 

CreateObject ("Photoshop. PathPointInfo") 
lineArray(1).Kind = 2 ' for PsPointKind --> 2 


Set lineArray (1) 


appRef .Documents.Add (5000, 


lineArray(1).Anchor = Array(100, 100) 


( 
lineArray(1).LeftDirection = lineArray(1).Anchor 
lineArray(1).RightDirection = lineArray(1) .Anchor 


'for PsDialogModes --> 3 


(psCornerPoint) 


startDisplayDialogs, docRef 
lineArray3 (3), lineSubPathArray (3), myPathItem 


(psPixels) 
(psPixels) 
(psDisplayNoDialogs) 


"Simple Line") 


left, and 
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Set lineArray(2) = CreateObject ("Photoshop. PathPointInfo") 
lineArray(2).Kind = 2 

lineArray (2) .Anchor = Array(150, 200) 
lineArray (2) .LeftDirection = lineArray (2) .Anchor 
lineArray (2) .RightDirection = lineArray (2) .Anchor 


Set lineSubPathArray(1) = CreateObject ("Photoshop.SubPathInfo") 
lineSubPathArray(1).operation = 2 'for PsShapeOperation --> 2 (psShapeXOR) 
lineSubPathArray(1).Closed = false 

lineSubPathArray(1).entireSubPath = lineArray 


'line#2 
Set lineArray2(1) = CreateObject ("Photoshop.PathPointInfo") 
lineArray2(1).Kind = 2 


lineArray2(1).Anchor = Array(150, 200) 
lineArray2(1).LeftDirection = lineArray2 (1) .Anchor 
lineArray2(1).RightDirection = lineArray2 (1) .Anchor 

Set lineArray2(2) = CreateObject ("Photoshop.PathPointInfo") 
lineArray2 (2) .Kind = 2 

lineArray2 Anchor = Array(200, 100) 


(2). 
lineArray2 (2) .LeftDirection = lineArray2 (2) .Anchor 
lineArray2 (2) .RightDirection = lineArray2 (2) .Anchor 


Set lineSubPathArray(2) = CreateObject ("Photoshop.SubPathInfo") 
lineSubPathArray (2) .operation = 2 

lineSubPathArray (2) .Closed = false 
lineSubPathArray (2) .entireSubPath = lineArray2 

'draw the "ice cream" curve above the two lines already on the screen 
‘it’s a curved line, so there are 3 points, not 2 and the 
"coordinates for the middle point (lineArray3(1)) are different. 
'The left direction is positioned “above” the anchor on the screen. 
'The right direction is positioned “below” the anchor 

'You can change the coordinates for these points to see 

"how the curve works... 

Set lineArray3(1) = CreateObject ("Photoshop.PathPointInfo") 
lineArray3(1).Kind = 2 


lineArray3(1).Anchor = Array(200, 100) 
lineArray3 (1) .LeftDirection = lineArray3 (1) .Anchor 
lineArray3 (1) .RightDirection = lineArray3 (1) .Anchor 

Set lineArray3(2) = CreateObject ("Photoshop.PathPointInfo") 
lineArray3 (2) .Kind = 2 

lineArray3 (2) .Anchor = Array(150, 50) 
lineArray3 (2) .LeftDirection = Array(100, 50) 
lineArray3 (2) .RightDirection = Array(200, 50) 

Set lineArray3(3) = CreateObject ("Photoshop.PathPointInfo") 
lineArray3 (3) .Kind = 2 

lineArray3 Anchor = Array(100, 100) 


(3). 
lineArray3 (3) .LeftDirection = lineArray3 (3) .Anchor 
lineArray3 (3) .RightDirection = lineArray3 (3) .Anchor 


Set lineSubPathArray(3) = CreateObject ("Photoshop.SubPathInfo") 
lineSubPathArray (3) .operation = 2 

lineSubPathArray (3) .Closed = false 
lineSubPathArray (3) .entireSubPath = lineArray3 


‘create the path item 
Set myPathItem = docRef.PathItems.Add("A Line", lineSubPathArray) 
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' stroke it so we can see something 
myPathItem.StrokePath(2) 'for PsToolType --> 2 (psBrush) 


' Reset the application preferences 
Preferences.RulerUnits = startRulerUnits 


Preferences.TypeUnits = startTypeUnits 


DisplayDialogs = startDisplayDialogs 
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The collection of PathItem objects in the document. 


Note: See ‘Pathltem’ on page 95 for information on PathItem objects. 
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Property Value Type What it is 
Application Object Read-only. The application that the collection belongs to. 
(Application) 
Count Number (Long) Read-only. The number of PathItem objects in the 
PathItems collection. 
Item Read-only. Gets an element from the collection. 


Object (PathItem) 


Parent Object (Document) Read-only. The PathItems object's container. 
typename String Read-only. The class name of the referenced PathItems 
object. 

Method Parameter Type Returns What it does 

Add PathiItem Creates anew PathItem object. 
(Name, String 
Ent irePath) Array (SubPathItem objects) 

Index Bamber Gets a PathItem object from the 
(ItemPtr) Object (PatuTtEm) ong PathItems collection. 

RemoveAll Removes all PathItem objects from the 


() 


PathItems collection. 
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Note: You do not use the PathPoint object to create points that make up a path. Rather, you use the 
PathPoint object to retrieve information about the points that describe path segments. To create 
path points, use the PathPoint Info objects. See ‘PathPointInfo’ on page 137. 


Property 


Anchor 


Value Type 


Array (UnitValue) 


What it is 


Read-write. The point on the curve 


Application 


Kind 


LeftDirection 


Parent 


RightDirection 


typename 


Object (Application) 


PsPointKind 


Array (UnitValue 


Object (SubPathItem) 


Array (UnitValue) 


String 


(LeftDirection/RightDirectionare 
points representing the control handle 
end points). 


Read-only. The application that the 
collection belongs to. 


Read-write. The PathPoint object's 
type. 


Read-write. The x and y coordinates that 
define the left handle. 


Read-only. The PathPoint object's 
container. 


Read-write. The x and y coordinates that 
define the right handle. 


Read-only. The class name of the 
referenced PathPoint object. 
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A point on a path, expressed as an array of three coordinate arrays: the anchor point, left direction point, 
and right direction point. For paths that are straight segments (not curved), the coordinates of all three 
points are the same. For curved segments, the coordinates are different. The difference between the 
anchor point and the left or right direction points determines the arc of the curve. You use the left 
direction point to bend the curve “outward” or make it convex; you use the right direction point to bend 
the curve “inward” or make it concave. 


Property Value Type What it is 


Anchor Array Read-write. The x and y coordinates of one end point of the 
path segment. 


Application Object (Application) Read-only. The application that the collection belongs to. 

Kind PsPointKind Read-write. The PathPointInfo object's kind. 

LeftDirection Array (UnitValue) Read-write. The location of the left direction point (‘in’ 
position). 

RightDirection Array (UnitValue) Read-write. The location of the right handle (‘out’ position). 

typename String Read-only. The class name of the referenced PathPoint Info 


object. 
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A collection of PathPoint objects that comprises the PathPoints property of the SubPathItem object. 


Note: See ‘SubPathltem’ on page 131 for more information. 


Property Value Type What it is 

Application Object (Application) Read-only. The application that the collection belongs to. 

Count Number (Long) Read-only. The number of elements in the PathPoints 
collection. 

Item Read-only. Gets an element from the collection. 

Object (PathPoint) 

Parent Object (SubPathItem) Read-only. The PathPoints object's container. 

typename String Read-only. The class name of the referenced PathPoints 
object. 

Method Parameter type Returns What it does 

Index Number Gets an element from the PathPoints 

(ItemPtr) Object PATHPCLRE) (tong) collection. 
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Options that can be specified when opening a document in generic PDF format. 


Property Value Type What it is 

AntiAlias Boolean Read-write. Indication of whether to use antialias. 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

BitsPerChannel PsBitsPerChannelType |Read-write. The number of bits per channel. 

ConstrainProportions Boolean Deprecated for Adobe Photoshop CS2. 

CropPage PsCropToType Read-write. The method of cropping to use. 

Height UnitValue Deprecated for Adobe Photoshop CS2. 

Mode PsOpenDocumentMode Read-write. The color model to use. 

Name String Read-write. The name of the document. 

Page Number (Long) Read-write. The page to which to open the 
document. 

Resolution Number (Double) Read-write. The resolution of the document (in 


pixels per inch). 


SuppressWarnings Boolean Read-write. Indication of whether to suppress 
warnings when opening the document. 


Typename String Read-only. The class name of the referenced 
PDFOpenOpt ions object. 


UsePageNumber Boolean Read-write. Indication of whether the value 
specified in the page property will refer to an 
image number when usePageNumber = false. 


See Page. 
Width UnitValue Deprecated for Adobe Photoshop CS2. 
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Options that can be specified when saving a document in PDF format. 


Property Value Type What it is 

AlphaChannels Boolean Read-write. Indication of whether to save 
the alpha channels with the file. 

Annotations Boolean Read-write. Indication of whether to save 
comments with the file. 

Application Object (Application) Read-only. The application that the 
collection belongs to. 

ColorConversion Boolean Read-write. Indication of whether to 
convert the color profile to a destination 
profile. 

ConvertToEightBit Boolean Read-write. Indication of whether to 
convert a 16-bit image to 8-bit for better 
compatibility with other applications. 

Descripton String Read-write. Description of the save options 
to use. 

DestinationProfile String Read-write. Description of the final RGB or 
CMYK output device, such as a monitor or a 
press standard. 

DowngradeColorProfile Boolean Deprecated for Adobe Photoshop CS2. 

DownSample PsPDFResampleType Read-write. The down sample method to 
use. 

DownSampleSize Number (Double) Read-write. The size to downsample images 
if they exceed the limit in pixels per inch. 

DownSampleSizeLimit Number (Double) Read-write. Limits downsampling or 
subsampling to images that exceed this 
value in pixels per inch. 

EmbedColorProfile Boolean Read-write. Indication of whether to embed 
the color profile in the document. 

EmbedFonts Boolean Deprecated for Adobe Photoshop CS2. 

EmbedThumbnail Boolean Read-write. Indication of whether to include 
a small preview image in Adobe PDF files. 

Encoding PsPDFEncoding Read-write. The encoding method to use. 
Default: 1 (psPDFZIP). 

Interpolation Boolean Deprecated for Adobe Photoshop CS2. 
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Property 


Value Type 


What it is (Continued) 


JPEGQuality 


Layers 


OptimizeForWeb 


OutputCondition 


OutputConditionID 


PDFCompatibility 


PDFStandard 


PreserveEditing 


PresetFile 


ProfileInclusionPolicy 


RegistryName 


SpotColors 


TileSize 


Transparency 


Number (Long) 


Boolean 


Boolean 


String 


String 


PsPDFCompatibilityType 


PsPDFStandardType 


Boolean 


String 


Boolean 


String 


Boolean 


Number (Long) 


Boolean 


Read-write. The quality of the produced 
image (0 - 12), which is inversely 
proportionate to the compression amount. 


Note: Valid only when 


Encoding = 2 (psPDFJPEG). 


Read-write. Indication of whether to save 
the document's layers. 


Read-write. Indication of whether to 
improve performance of PDF files on Web 
servers. 


Read-write. An optional comment field for 
inserting descriptions of the output 
condition. The text is stored in the PDF/X 
file. 


Read-write. Indentifier for the output 
condition. 


Read-write. The PDF version to make the 
document compatible with. 


Read-write. The PDF standard to make the 
document compatible with. 


Read-write. Indication of whether to reopen 
the PDF in Adobe Photoshop CS2 with 
native Photoshop data intact. 


Read-write. The preset file to use for 
settings. 


Note: This option overrides other settings. 


Read-write. Indication of whether to show 
which profiles to include. 


Read-write. URL where the output condition 
is registered. 


Read-write. Indication of whether to save 
spot colors. 


Read-write. Compression option. 


Note: Valid only when encoding = 
PDFEncoding.JPEG2000. 


Deprecated for Adobe Photoshop CS2. 
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Property Value Type What it is (Continued) 

typename String Read-only. The class name of the referenced 
PDFSaveOptions object. 

UseOutlines Boolean Deprecated for Adobe Photoshop CS2. 

VectorData Boolean Deprecated for Adobe Photoshop CS2. 

View Boolean Read-write. Indication of whether to open 


the saved PDF in Adobe Acrobat. 
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Options to be specified when opening a Kodak Photo CD (PCD) files, including high-resolution files from 


Pro Photo CD discs. 

Property Value Type What it is 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

ColorProfileName String Read-write. The profile to use when reading the 
image. 

ColorSpace PsPhotoCDColorSpace /Read-write. The colorspace for the image. 

Orientation PsOrientation Read-write. The image orientation. 

PixelSize PsPhotoCDSize Read-write. The image dimensions. 

Resolution Number (Double) Read-write. The image resolution (in pixels per 
inch). 

typename String Read-only. The class name of the referenced 


PhotoCDOpenOptions object. 
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Options that can be specified when saving a document in PSD format. 


Property Value Type What it is 

AlphaChannels Boolean Read-write. Indication of whether to save the alpha 
channels. 

Annotations Boolean Read-write. Indication of whether to save the 
annotations. 

Application Object Read-only. The application that the collection 

(Application) 

belongs to. 

EmbedColorProfile Boolean Read-write. Indication of whether to embed the 
color profile in the document. 

Layers Boolean Read-write. Indication of whether to preserve the 
layers. 

SpotColors Boolean Read-write. Indication of whether to save the spot 
colors. 

typename String Read-only. The class name of the referenced 


PhotoshopSaveOptions object. 
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Options that can be specified when saving a document in PICT format. 


Property Value Type What it is 

AlphaChannels Boolean Read-write. Indication of whether to save the 
alpha channels. 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

Compression PsPICTCompression Read-write. Default: 1) 

EmbedColorProfile Boolean Read-write. Indication of whether to embed the 
color profile in the document. 

Resolution PsPICTBitsPerPixels Read-write. The number of bits per pixel. 

typename String Read-only. The class name of the referenced 


PICTFileSaveOptions object. 
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Options that can be specified when saving a document as a PICT Resource file. 


Property Value Type What it is 
AlphaChannelChannels Boolean Read-write. Indication of whether to save the alpha 
channels. 
Application Object Read-only. The application that the collection 
(Application) 
ee belongs to. 
Compression PsPICTCompression = Read-write. The type of compression to use. Default: 
1 (psNoPICTCompression). 
EmbedColorProfile Boolean Read-write. Indication of whether to embed the 
color profile in the document. 
Name String Read-write. The name of the PICT resource. 
Resolution PsPICTBitsPerPixels Read-write. The number of bits per pixel. 
ResourceID Number (Long) Read-write. The ID of the PICT resource. Default: 128. 
typename String Read-only. The class name of the referenced 


PICTResourceSaveOptions object. 
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Property Value type What it is 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

Content PsPicturePackageTextType Read-write. The content information. Default: 
0 (psNoText). 

Flatten Boolean Read-write. Indicates whether all layers in the 
final document are flattened. Default: true. 

Font PsGalleryFontType Read-write. The font used for security text. 
Default: 1 (psArial). 

FontSize Number (Long) Read-write. The font size used for security text. 
Default: 12. 

Layout String Read-write. The layout to use to generate the 
picture package. Default: “ (2) 5x7”. 

Mode PsNewDocumentMode Read-write. Read-write. The color profile to 
use as the document mode. Default: 2 
(psNewRGB). 

Opacity Number (Long) Read-write. The Web page security opacity as 
a percent. Default: 100. 

Resolution Number (Double) Read-write. The resolution of the document in 
pixels per inch. Default: 72 . 0. 

Text String Read-write. The picture package custom text. 
Note: Valid only when content = 2 

(psUserText ). See Content. 

TextColor RGBColor Read-write. The color to use for security text. 

TextPosition PsGallerySecurityTextPositionType Read-write. The security text position. Default: 
1 (psCentered). 

TextRotate PsGallerySecurityTextRotateType Read-write. The orientation to use for security 
text. Default: 1 (psZero). 

typename String Read-only. The class name of the referenced 


PicturePackageOptions object. 
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Property Value Type What it is 


AlphaChannels Boolean Read-write. Indication of whether to 
save the alpha channels. 


Application Object (Application) Read-only. The application that the 
collection belongs to. 


typename String Read-only. The class name of the 
referenced PixarSaveOptions 
object. 
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Options that can be specified when saving a document in PNG format. 


Property Value Type What it is 
Application Object (Application) Read-only. The application that the collection belongs to. 
Interlaced Boolean Read-write. Indicates whether the should rows be 


interlaced. Default: false. 


typename String Read-only. The class name of the referenced 
PNGSaveOptions object. 


Adobe Photoshop CS2 
VBScript Scripting Reference VBScript Interface 114 


Options to define for the Preferences property of the app object. See ‘Preferences’ on page 17 (in the 
Properties table for the app object). 


Note: Defining the Preferences properties is basically equivalent to selecting Edit > Preferences 
(Windows) or Photoshop > Preferences in the Adobe Photoshop CS2 application. For explanations 
of individual settings, please refer to Adobe Photoshop CS2 Help. 
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Property Value Type What it is 
AdditionalPluginFolder String Read-write. The path to an additional 
plug-in folder. 
Note: Valid only when 
UseAdditionalPluginFolder = 
true. See 
UseAdditionalPluginFolder. 
AppendExtension PsSaveBehavior Read-write. Save files with extensions on 
Windows. 
Application Object (Application) Read-only. The application that the 


AskBeforeSavingLayeredTIFF 


AutoUpdateOpenDocuments 


BeepWhenDone 


ColorChannelsInColor 


ColorPicker 


ColumnGutter 


ColumnWidth 


CreateFirstSnapshot 


DynamicColorSliders 


EditLogItems 


ExportClipboard 


Boolean 


Boolean 


Boolean 


Boolean 


PsColorPicker 


Number (Double) 


Number (Double) 


Boolean 


Boolean 


PsEditLogItemsType 


Boolean 


collection belongs to. 


Read-write. Indication of whether to ask 
the user to verify layer preservation 
options when saving a file in TIFF format. 


Read-write. Indication of whether to 
automatically update open documents. 


Read-write. Indication of whether to 
beep when a process finishes. 


Read-write. Indication of whether to 
display component channels in the 
Channels palette in color. 


Read-write. 


Read-write. The width of the column 
gutters (in points). (0.1 - 600.0). 


Read-write. Column width (in points) (0.1 
- 600.0). 


Read-write. Indication of whether to 
automatically make the first snapshot 
when a new document is created. 


Read-write. Indication of whether 
dynamic color sliders appear in the Color 
palette. 


Read-write. The options for editing 
history log items. 


Note: Valid only when UseHistoryLog 
= true. See UseHistoryLog. 


Read-write. Indication of whether to 
retain Adobe Photoshop CS2 contents 
on the clipboard after you exit the 
application. 
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Property Value Type What it is (Continued) 

FontPreviewSize psFontPreviewType Read-write. Indication of whether to 
show font previews in the type tool font 
menus. 

GamutWarningOpacity Number (Double) Read-write. (0 - 100 as percent). 

GridSize PsGridSize Read-write. The size to use for squares in 
the grid. 

GridStyle PsGridLineStyle Read-write. The formatting style for 
non-printing grid lines. 

GridSubDivisions Number (Long) Read-write. (1 - 100) 

GuideStyle PsGuideLineStyle Read-write. The formatting style for 
non-printing guide lines. 

ImageCacheForHistograms Boolean Read-write. Indication of whether to use 


ImageCacheLevels 


ImagePreviews 


Interpolation 


KeyboardZoomResizesWindows 


MaximizeCompatibility 


MaxRAMuse 


NonLinearHistory 


NumberOfHistoryStates 


OtherCursors 


PaintingCursors 


Number (Long) 


PsSaveBehavior 


PsResampleMethod 


Boolean 


PsQueryStateType 


Number (Long) 


Boolean 


Number (Long) 


the sampled data cache for histograms in 
the Level dialog (faster but not as 
accurate). 


Read-write. The number of images to 
hold in the cache (1 - 8). 


Read-write. The behavior mode to use 
when saving files. 


Read-write. The method to use to assign 
color values to any new pixels created 
when an image is resampled or resized. 


Read-write. Indication of whether to 
automatically resize the window when 
zooming in or out using keyboard 
shortcuts. 


Read-write. The behavior to use to check 
whether to maximize compatibility when 
opening Adobe Photoshop CS2 (PSD) 
files. 


Read-write. The maximum percentage of 
available RAM used by Adobe Photoshop 
CS2 (5 - 100). 


Read-write. Indication of whether to 
allow non-linear history. 


Read-write. The number of history states 
to preserve (1 - 100). 


PsOtherPaintingCursors Read-write. The type of pointer to use. 


PsPaintingCursors 


Read-write. The type of pointer to use. 
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Property Value Type What it is (Continued) 
Parent Object (Application) Read-write. The Preferences object's 
container. 
PixelDoubling Boolean Read-write. Indication of whether to 


halve the resolution or (double the size 
of pixels) to make previews display more 


quickly. 
PointSize PsPointType Read-write. The point/pica size. 
RecentFileListLength Number (Long) Read-write. The number of items in the 


recent file list (0 - 30). 


RulerUnits PsUnits Read-write. The unit the scripting system 
will use when receiving and returning 
values. 

SaveLogItems PsSaveLogitemsType Read-write. The options for saving the 


history items. 


SaveLogItemsFile String Read-write. The path to the history log 
file. 

SavePaletteLocations Boolean Read-write. Indication of whether to 
make new palette locations the default 
location. 

ShowAsianTextOptions Boolean Read-write. Indication of whether to 


display Asian text options in the 
Paragraph palette. 


ShowEnglishFontNames Boolean Read-write. Indication of whether to list 
Asian font names in English. 


ShowSliceNumber Boolean Read-write. Indication of whether to 
display slice numbers in the document 
window when using the Slice tool. 


ShowToolTips Boolean Read-write. Indication of whether to 
show pop up definitions on mouse over. 


SmartQuotes Boolean Read-write. Indication of whether to use 
curly or straight quote marks. 


typename String Read-only. The class name of the 
referenced Preferences object. 


TypeUnits PsTypeUnits Read-write. The unit type-size that the 
numeric inputs are assumed to 
represent. 

UseAdditionalPluginFolder Boolean Read-write. Indication of whether to use 


an additional folder for compatible 
plug-ins stored with a different 
application. 
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Property Value Type What it is (Continued) 


UseDiffusionDither Boolean Read-write. Indication of whether to use 
diffusion dithering to minimize 
distinctive patterning caUsed by pattern 
dithering. 


UseHistoryLog Boolean Read-write. Indication of whether to 
create a log file for history states. 


UseLowerCaseExtension Boolean Read-write. Indicates whether the file 
extension should be lowercase. 


UseShiftKeyForToolSwitch Boolean Read-write. Indication of whether to 
enable cycling through a set of hidden 
tools. 

UseVideoAlpha Boolean Read-write. Indication of whether to 


enable Adobe Photoshop CS2 to send 
transparency information to your 
computer's video board. (Requires 
hardware support.) 


WindowsThumbnail Boolean Read-write. (Requires hardware support.) 
Indication of whether to create a 
thumbnail when saving the image on 
Windows. 
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Options that can be specified for PDF presentations. 


Property Value Type What it is 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

AutoAdvance Boolean Read-write. Indication of whether to auto 


advance images when viewing the presentation. 
Default: true. 


Note: Valid only when Presentation = true. 
See Presentation. 


IncludeFilename Boolean Read-write. Indication of whether to include the 
file name for the image (default: false). 


Interval Number (Long) Read-write. The time in seconds before the view 
is auto advanced (1 - 60; default: 5). 


Note: Valid only when AutoAdvance = true. 
See AutoAdvance. 


Loop Boolean Read-write. Indication of whether to begin the 
presentation again after the last page. Default: 
false. 


Note: Valid only when AutoAdvance = true. 
See AutoAdvance. 


Magnification PsMagnificationType Read-write. The magnification type to use when 
viewing the image. 


PDFFileOptions PDFSaveOptions Read-write. Options to use when creating the 
PDF file. 
Presentation Boolean Read-write. Indication of whether the output will 


be a presentation. Default: false); when false, 
the output is a Multi-Page document. 


Transition PsTransitionType Read-write. The transition from one image to the 
next. Default: 9 (psNoTransition). 


Note: Valid only when AutoAdvance = true. 
See AutoAdvance. 


typename String Read-only. The class name of the referenced 
PDFPresentationOptions object. 
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Options that can be specified when opening a document in RAW format. 


Property Value Type What it is 
Application Object Read-only. The application that the collection belongs 
(Application) 
to. 
BitsPerChannel Number (Long) Read-write. The number of bits for each channel. 
Note: The only valid values are BitsPerChannel = 8 
Or BitsPerChannel = 16. 
ByteOrder PsByteOrder Read-write. The order in which bytes will be read. 
Note: Valid only when 
BitsPerChannel = 16.See BitsPerChannel. 
ChannelNumber Number (Long) Read-write. The number of channels in the image 
(1 - 56). 
Note: The value of ChannelNumber cannot exceed the 
number of channels in the image. When 
BitsPerChannel = 16, only the following 
values are valid: 1, 3, or 4. See BitsPerChannel. 
HeaderSize Number (Long) Read-write. The number of bytes of information that 
will appear in the file before actual image information 
begins; that is, the number of zeroes inserted at the 
beginning of the file as placeholders (0 - 1919999). 
Height Number (Long) Read-write. The height of the image (in pixels). 
InterleaveChannels Boolean Read-write. Indication of whether to store color values 
sequentially. 
RetainHeader Boolean Read-write. Indication of whether to retain the header 
when saving. 
Note: Valid only when HeaderSize is 1 or greater. 
typename String Read-only. The class name of the referenced 
RawFormatOpenOptions object. 
Width Number (Long) Read-write. The image width in pixels. 
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Property Value Type What it is 

AlphaChannels Boolean Read-write. Indicates whether alpha 
channels should be saved. 

Application Object (Application) Read-only. The application that the 
collection belongs to. 

SpotColors Boolean Read-write. Indicates whether the spot 
colors should be saved. 

typename String Read-only. The class name of the 


referenced RawSaveOptions object. 
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Property Value Type What it is 

Application Object (Application) Read-only. The application that the 
collection belongs to. 

Blue Number (Double) Read-write. The blue color value ( 
0.0 - 255.0; default: 255.0). 

Green Number (Double) Read-write. The green color value 
(0.0 - 255.0; default: 255.0). 

HexValue String Read-write. The hex representation of the 
color. 

Red Number (Double) Read-write. The red color value 
(0.0 - 255.0; default: 255.0). 

typename String Read-only. The class name of the 


referenced RGBColor object. 
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Property Value Type What it is 
Application Object (Application) Read-only. The application that the 
collection belongs to. 
Bounds array of UnitValues Read-only. The bounding rectangle of the 
entire selection. 
Parent Object (Document) Read-only. The object's container. 
typename String Read-only. The class name of the 
referenced Selection object. 
Method Parameter Type Returns What it does 
Clear Clears the selection and does 
() not copy it to the clipboard. 
Contract Contracts the selection by the 
(By) Number (Double) specified amount. 
Copy Copies the selection to the 
( [Merge] ) Boolean clipboard. When the optional 
argument is used and set to 
true, a merged copy is 
performed (all visible layers in 
the selection are copied). 
Cut Clears the current selection and 
() copies it to the clipboard. 
Deselect Deselects the current selection. 
Q 
Expand Expands the selection by the 
(By) Number (Double) specified amount. 
Feather Feathers the edges of the 
(By) Number (Double) selection by the specified 
amount. 
Fill Fills the selection (Opacity: 1 - 
: Object (SolidColor, 
ae es ArtLayer, HistoryState) ; 100 as percent). 
' or String 
[, Opacity] PsColorBlendMode 


[, PreserveTransparency] ) 


Number (Long) 
Boolean 
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Method Parameter Type Returns What it does (Continued) 
Grow Grows the selection to include 
(Tolerance, DA (Long) all adjacent pixels falling within 
AntiAlias) E the specified tolerance range. 
Invert Inverts the selection (deselects 
() the selection and selects the rest 
of the layer or document). 
Note: To flip the selection 
shape, see Rotate. 
Load Loads the selection from the 
(From epenset specified channel. 
| Combination] PsSelectionType 
, Inverting] ) Boolean 
MakeWorkPath Number (Double) Makes this selection item the 
( [Tolerance] ) work path for this document. 
Resize Resizes the selected area to the 
( [Horizontal] Number (Double) specified dimensions and 
, Vertical] Number (Double) ee 
, Anchor] ) PsAnchorPosition anchor position. 
ResizeBoundary Changes the size of the 
( [Horizontal] Number (Double) selection to the specified 
, Vertical] sues (Double) dimensions around the 
PsAnchorPosition E 
, Anchor]) specified anchor. 
Rotate Rotates the selection by the 
(Angle ae heer specified amount around the 
[, Anchor] ) SIRE SCS LEE specified anchor point. 
RotateBoundary Rotates the boundary of the 
(Angle ear’ (Double) selection around the specified 
[, Anchor] ) PsAnchorPosition anchor. 
Select Selects the specified region. 
; Array (Points: 
(Region Array (Array (x,y),...) 
[, Type] PsSelectionType 
[, Feather] Number (Double) 
[, AntiAlias]) Boolean 
SelectAll Selects the entire layer. 
Q 
SelectBorder Selects the selection border only 
(Width) Number (Double) (in the specified width); 


subsequent actions do not 
affect the selected area within 
the borders. 
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Method Parameter Type Returns What it does (Continued) 
Similar Grows the selection to include 
(Tolerance, aaa (Long) pixels throughout the image 
AntiAlias) a falling within the tolerance 
range. 
Smooth Cleans up stray pixels left inside 
(Radius) Number Long) or outside a color-based 


selection (within the radius 
specified in pixels). 


apa Saves the selection as a channel. 
(Into ae l 
[, Combination] ) PsSelectionType 
nee Strokes the selection border 
pee ieee canoe auc (Opacity: 1 - 100 as percent). 
Width Number (Long) — 
, Location] Psst rokerocation 
, Mode] PsColorBlendMode 
, Opacity] eerie (Long) 
, PreserveTransparency] ) Boolean 
arano Moves the entire selection 
HDE G An relative to its current position. 
, Deltay]) UnitValue 
TranslateBoundary Moves the selection relative to 
Sean ane its current position. 
, DeltayY)) UnitValue 


> The following script creates a checkerboard using the following steps: 


1. 


2. 


Create an 800 x 800 pixel document. 
Divide the entire document into 100 x 100 pixel squares. 


Select every other square in the first row, then shift the selection criteria to select the alternate squares 
in the following row. Repeat until every other square in the document is selected. 


Fill the selected squares with the foreground color from the palette. 
Invert the selection and fill the newly selected squares with the background color from the palette. 


Deselect the squares to remove the selection outlines (the “marching ants"). 


Selection.vbs 


Dim appRef, startRulerUnits, startTypeUnits, startDisplayDialogs, docSize 

Dim cells, cellSize, checkersDoc, shiftIt, h, v, eventWait, enumRedrawComplete 
Dim typeState, keyState, desc 

Set appRef = CreateObject ("Photoshop.Application") 


' Save the current Preferences 
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startRulerUnits = appRef.Preferences.RulerUnits 
startTypeUnits = appRef.Preferences.TypeUnits 
startDisplayDialogs = appRef.DisplayDialogs 


' Set Photoshop CS2 to use pixels and display no dialogs 

appRef .Preferences.RulerUnits = 1 'for PsUnits --> 1 (psPixels) 

appRef .Preferences.TypeUnits = 1 'for PsTypeUnits --> 1 (psPixels) 
appRef .DisplayDialogs = 3 'for PsDialogModes --> 3 (psDisplayNoDialogs) 


' Close all the open documents 
Do While appRef.Documents.Count 

appRef .ActiveDocument .Close 
Loop 


' Create variables for the 800 pixel board divided in even 100 x 100 squares 
docSize = 800 

cells = 8 

cellSize = docSize / cells 


' create a new document 
Set checkersDoc = appRef.Documents.Add(docSize, docSize, 72, "Checkers") 


' Create a variable to use for selecting the checker board 

' That allows me to shift the selection one square to the right 
‘on every other row, and then shift back for the rows in between. 
shiftIt = true 


' loop through vertically to create the first row 
¥o =. 0 
For v = 0 To (docSize - 1) Step cellSize 

' Switch the shift For a new row 

shiftIt = Not shiftIt 


' loop through horizontally 
Hs 
For h = 0 To (docSize - 1) Step (cellSize * 2) 
' push over the cellSize to start with only 
If shiftIt And h = 0 Then 
h = h + cellSize 
End If 
' Select a square 
selRegion = Array (Array (h, v), 
Array (h + cellSize, v), _ 
Array (h + cellSize, v + cellSize), 
Array (h, v + cellSize), 
Array (h, v)) 


If h = 0 And v = 0 Then 
checkersDoc.Selection.Select (selRegion) 
Else 
checkersDoc.Selection.Select(selRegion, 2) ' for PsSelectionType --> 2 
(psExtendSelection) 
End If 


' turn this off for faster execution 
' turn this on for debugging 
WaitForRedraw 
Next 
Next 
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' Fill the current selection with the Foreground color 
checkersDoc.Selection.Fill (appRef .ForegroundColor) 


Invert the selection 
heckersDoc.Selection. Invert () 


Q 


Fill the new selection with the background color 
heckersDoc.Selection.Fill(appRef.BackgroundColor) 


Q 


Clear the selection to get rid of the non-printing borders 
checkersDoc.Selection.Deselect () 


' Reset the application preferences 

appRef .Preferences.RulerUnits = startRulerUnits 
appRef .Preferences.TypeUnits = startTypeUnits 
appRef .DisplayDialogs = startDisplayDialogs 


' A helper function for debugging 
' It also helps the user see what is going on 
' if you turn it off for this example you 
' get a flashing cursor for a Number (Long) time 
' Save a bit of time by creating the variables only once 
Private Sub WaitForRedraw 
If VarType(eventWait) = vbEmpty Then 
eventWait = appRef.charIDToTypeID ("Wait") 
End If 
If VarType (enumRedrawComplete) = vbEmpty Then 
enumRedrawComplete = appRef.charIDToTypeID("RdCm") 
End If 
If VarType(typeState) = vbEmpty Then 
typeState = appRef.charIDToTypeID("Stte") 
End If 
If VarType(keyState) = vbEmpty Then 
keyState = appRef.charIDToTypeID("Stte") 
End If 
If VarType (desc) = vbEmpty Then 
Set desc = CreateObject ("Photoshop.ActionDescriptor") 
desc.putEnumerated KeyState, typeState, enumRedrawComplete 
End If 
appRef .executeAction(eventWait, desc, 3) 'for PsDialogModes --> 3 
(psDisplayNoDialogs) 
End Sub 
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Options that can be specified when saving a document in SGIRGB format. 


Note: The SGIRGB format is not installed automatically with Adobe Photoshop CS2. 
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Property Value Type What it is 

AlphaChannels Boolean Read-write. Indication of whether to 
save the alpha channels. 

Application Object (Application) Read-only. The application that the 
collection belongs to. 

SpotColors Boolean Read-write. Indication of whether to 
save the spot colors. 

typename String Read-only. The class name of the 


referenced SGIRGBSaveOptions 
object. 
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A color definition used in the document. 
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Property Value Type What it is 

Application Object (Application) Read-only. The application that the collection belongs to. 

CMYK Object (CMYKColor) Read-write. The CMYK color mode. 

Gray Object (GrayColor) Read-write. The Grayscale color mode. 

HSB Object (HSBColor) Read-write. The HSB color mode. 

Lab Object (LabColor) Read-write. The LAB color mode. 

Model PsColorModel Read-write. The color model. 

NearestWebColor Object (RGBColor) Read-only. The nearest Web color to the current color. 

RGB Object (RGBColor) Read-write. The RGB color mode. 

typename String Read-only. The class name of the referenced Solidcolor 

object. 

Method Parameter Type Returns What it does 

IsEqual Boolean Indication of whether the SolidCcolor 
(Color) Solidcolor object is visually equal to the specified 


color. 
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An array of PathPoint Info objects that describes a straight or curved segment of a path. 


Property Value Type What it is 
Application Object Read-only. The application that the collection belongs 
(Application) 
to. 
Closed Boolean Read-write. Indication of whether the path describes 
an enclosed area. 
EntireSubPath Array (PathPoint Read-write. 
objects 
Operation PsShapeOperation Read-write. The sub path’s operation on other sub 
paths. 
typename String Read-only. The class name of the referenced 


SubPathInfo object. 
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Information about a path. 


Note: You do not use the SubPathItem object to create a path. Rather, you use the SubPathiInfo object 
to retrieve information about a path. (Note that all of the subPathItem object's properties are 
Read-only.) To create path segments, see SubPathInfo. 


Property 


Application 


Closed 
Operation 
Parent 


PathPoints 


typename 


Value Type What it is 

Object | Read-only. The application that the collection belongs to. 
(Application) 

Boolean Read-only. Indicates whether the path is closed. 


PsShapeOperation Read-only. The sub path operation on other sub paths. 


Object (PathItem) Read-only. The object's container. 


Object | Read-only. The PathPoints collection. 
(PathPoints) 
String Read-only. The class name of the referenced SubPathiItem 


object. 
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A collection of SubPathItem objects. See SubPathltem. 
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Property Value Type What it is 
Application Object Read-only. The application that the collection belongs to. 
(Application) 
Count Number (Long) Read-only. The number of elements inthe SubPathItems 
collection. 
Item Object Read-only. Gets an element from the collection. 
(SubPathItem) 
Parent Object (PathItem) Read-only. The SubPathItems object's container. 
typename String Read-only. The class name of the referenced SubPathItems 
object. 
Method Parameter type Returns What it does 
Index Object Number Gets an element from the SubPathItems 
(SubPathItem) (Long) : 
(ItemPtr) EE collection. 
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Options that can be set when saving a document in TGA (Targa) format. 


Property Value Type What it is 

AlphaChannels Boolean Read-write. Indication of whether to save the alpha 
channels. 

Application Object (Application) Read-only. The application that the collection belongs to. 

Resolution PsTargaBitsPerPixels |Read-write. The number of bits per pixel. Default: 24. 

RLECompression Boolean Read-write. Indicates whether RLE compression should 
be used. Default: true. 

typename String Read-only. The class name of the referenced 


targaSaveOptions object. 
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Details about a font in the Text Fonts collection. 


Note: See TextFonts for more information on the Text Fonts collection. 


Property Value Type What it is 

Application Cees) Read-only. The application that the collection belongs to. 
Family String Read-only. The font family. 

Name String Read-only. The name of the font. 

Parent Gabe Read-only. The object's container. 

PostScriptName String Read-only. The PostScript name of the font. 

Style String Read-only. The font style. 

typename String Read-only. The class name of the referenced Text Font 


object. 
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The collection of fonts available on your computer. 


Note: The Text Fonts object corresponds to the fonts property of the app object. In a script, you use 
fonts to refer to a Text Fonts object. The following sample demonstrates how to use the count 


property of the Text Fonts object to display a dialog that indicates the number of fonts installed on 
the machine. 


e Correct: 
Alert appRef.Fonts.Count 
e Incorrect: 
Alert appRef.TextFonts.Count 
See Application’, specifically the Fonts property, for more information. 


Property Value Type What it is 
Application Object | Read-only. The application that the collection belongs to. 
(Application) 
Count Number (Long) Read-only. The number of elements in the Text Fonts collection. 
Item Object Read-only. Gets an element from the collection. 
(Text Font ) 
Parent Object Read-only. The object's container. 
(Application) 
typename String Read-only. The class name of the referenced TextFonts object. 
Method Parameter Type Returns What it does 
Index Number (Long) (Gets an element from the TextFonts 


Object (TextFont) 


(ItemPtr) collection. 
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The text in an ArtLayer object whose Kind property's value is 2. 


Note: See ArtLayer, specifically the Kina property, for more information. 


Property Value Type What it is 
AlternateLigatures Boolean Read-write. Indication of whether to use alternate 
ligatures. 
Note: Alternate ligatures are the same as 
Discretionary Ligatures. Please refer to 
Adobe Photoshop CS2 Help for more 
information. 
AntiAliasMethod PsAntiAlias Read-write. The method of anti aliasing to use. 
Application Object Read-only. The application that the collection 
(Application) 
——EEE belongs to. 
AutoKerning PsAutoKernType Read-write. The auto kerning option to use. 
AutoLeadingAmount Number (Double) Read-write. The percentage to use for auto. Default) 
leading (0.01 - 5000.00 in points). 
Note: Valid only when UseAutoLeading = true. 
See UseAutoLeading. 
BaselineShift Number (Double) Read-write. The unit value to use in the baseline 
offset of text. 
Capitalization PsCase Read-write. The text case. 
Color Object Read-write. The text color. 
(SolidColor) 
Contents String Read-write. The actual text in the layer. 
DesiredGlyphScaling Number (Double) Read-write. The desired amount (percentage) to 


scale the horizontal size of the text letters (50 - 200; 
at 100, the width of characters is not scaled). 


Note: Valid only when Justification = 4 
(psLeftJustified); Justification = 5 
(psCenterJustified); Justification = 
6 (psRightJustified);oOr Justification 
= 7 (psFullydustified).See Justification. 
The following values are also required: 


MinimumGlyphScaling and 
MaximumGlyphScaling. 
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Property 


Value Type 


What it is (Continued) 


DesiredLetterScaling 


Note: ‘Letter Scaling’ is 
basically equivalent to 
‘Letter Spacing’ in the 
Adobe Photoshop CS2 
application Justification 
dialog (Select 
Justification on the 
Paragraphs palette 
menu). 


DesiredWordScaling 


Note: ‘Word Scaling’ is 
basically equivalent to 
‘Word Spacing’ in the 
Adobe Photoshop CS2 
application Justification 
dialog (Select 
Justification on the 
Paragraphs palette 
menu). 


Direction 


FauxBold 


FauxItalic 


FirstLineIndent 


Font 


HangingPunctuation 


Height 


Number (Double) 


Number (Double) 


PsDirection 


Boolean 


Boolean 


Number 


String 


Boolean 


Number 


(Double) 


(Double) 


Read-write. The amount of space between letters 
(100 - 500; at 0, no space is added between letters). 


Note: Valid only when Justification = 4 
(psLeftJustified); Justification = 5 
(psCenterJustified); Justification = 
6 (psRightJustified);or Justification 
= 7 (psFullydustified). See Justification. 
The following values are also required: 
MinimumLetterScaling and 
MaximumLetterScaling. 


Read-write. The amount (percentage) of space 
between words (0 -1000; at 100, no additional space 
is added between words). 


Note: Valid only when Justification = 4 
(psLeftJustified); Justification = 5 
(psCenterJustified); Justification = 
6 (psRightJustified);oOr Justification 
= 7 (psFullydustified). See Justification. 
The following values are also required: 
MinimumWordScaling and 
MaximumWordScaling. 


Read-write. The text orientation. 


Read-write. Indication of whether to use faux bold. 
Default: false 


Note: Using FauxBold.true is equivalent to 
selecting text and clicking the Faux Bold 
button in the Character palette. 


Read-write. Indication of whether to use faux italic. 
Default: false 


Note: Using FauxItalic.true is equivalent to 
selecting text and clicking the Faux Italic 
button in the Character palette. 


Read-write. The amount (unit value) to indent the 
first line of paragraphs (-1296 - 1296). 


Read-write. The text face of the character. 


Read-write. Indication of whether to use roman 
Hanging Punctuation. 


Read-write. The height of the bounding box (unit 
value) for paragraph text. 


Note: Valid only when Kind = 2 
(psParagraphText). See Kind. 
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Property Value Type What it is (Continued) 

HorizontalScale Number (Long) Read-write. Character scaling (horizontal) in 
proportion to vertical scale (0 - 1000 in percent). 
See VerticalScale. 

HyphenateAfterFirst Number (Long) Read-write. The number of letters after which 
hyphenation in word wrap is allowed (1 - 15). 

HyphenateBeforeLast Number (Long) Read-write. The number of letters before which 
hyphenation in word wrap is allowed (1 - 15). 

HyphenateCapitalWords Boolean Read-write. Indication of whether to allow 


HyphenateWordsLongerThan 


Hyphenation 


HyphenationZone 


HyphenLimit 


Justification 
Kind 

Language 
Leading 


LeftIndent 


Ligatures 


MaximumGlyphScaling 


Number (Long) 


Boolean 


Number (Double) 


Number (Long) 


PsJustification 


PsTextType 
PsLanguage 
Number (Double) 


Number (Double) 


Boolean 


Number (Double) 


hyphenation in word wrap of capitalized words. 


Read-write. The minimum number of letters a word 
must have in order for hyphenation in word wrap to 
be allowed (2 - 25). 


Read-write. Indication of whether to use 
hyphenation in word wrap. 


Read-write. The distance at the end of a line that 
will cause a word to break in unjustified type (0 - 
720 pica). 


Read-write. The maximum number of consecutive 
lines that can end with a hyphenated word. 


Read-write. The paragraph justification. 
Read-write. The text-wrap type. 

Read-write. The language to use. 
Read-write. The leading amount (unit value). 


Read-write. The amount (unit value) of space to 
indent text from the left (-1296 - 1296). 


Read-write. Indication of whether to use ligatures. 


Read-write. The maximum amount (percentage) to 
scale the horizontal size of the text letters (50 - 200; 
at 100, the width of characters is not scaled). 


Note: Valid only when Justification = 4 
(psLeftJustified); Justification = 5 
(psCenterJustified); Justification = 
6 (psRightJustified);or Justification 
= 7 (psFullydustified). See Justification. 
The following values are also required: 
MinimumGlyphScaling and 
DesiredGlyphScaling. 
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Property 


Value Type What it is (Continued) 


MaximumLetterScaling 


Note: ‘Letter Scaling’ is 
basically equivalent to 
‘Letter Spacing’ in the 
Adobe Photoshop CS2 
application Justification 
dialog (Select 
Justification on the 
Paragraphs palette 
menu). 


MaximumWordScaling 


Note: ‘Word Scaling’ is 
basically equivalent to 
‘Word Spacing’ in the 
Adobe Photoshop CS2 
application Justification 
dialog (Select 
Justification on the 
Paragraphs palette 
menu). 


MinimumGlyphScaling 


MinimumLetterScaling 


Note: ‘Letter Scaling’ is 
basically equivalent to 
‘Letter Spacing’ in the 
Adobe Photoshop CS2 
application Justification 
dialog (Select 
Justification on the 
Paragraphs palette 
menu). 


Number (Double) Read-write. The maximum amount of space to 
allow between letters (100 - 500; at 0, no space is 


added between letters). 


Note: Valid only when Valid only when 
Justification = 4 (psLeftJustified); 
Justification = 5 
(psCenterJustified); Justification = 
6 (psRightJustified);oOr Justification 
= 7 (psFullyJustified). See Justification. 
The following values are also required: 
MaximumLetterScaling and 


DesiredLetterScaling. 


Number (Double) Read-write. The maximum amount (percentage) of 
space to allow between words (0 -1000; at 100, no 


additional space is added between words). 


Note: Valid only when Justification = 4 
(psLeftJustified); Justification = 5 
(psCenterJustified); Justification = 
6 (psRightJustified);oOrJdustification 
= 7 (psFullydustified). See Justification. 
The following values are also required: 
MaximumWordScaling and 
DesiredWordScaling. 


Number (Double) Read-write. The minimum amount (percentage) to 
scale the horizontal size of the text letters (50 - 200; 


at 100, the width of characters is not scaled). 


Note: Valid only when Justification = 4 
(psLeftJustified); Justification = 5 
(psCenterJustified); Justification = 
6 (psRightJustified);oOr Justification 
= 7 (psFullydustified). See Justification. 
The following values are also required: 
MaximumGlyphScaling and 
DesiredGlyphScaling. 


Number (Double) Read-write. The minimum amount (percentage) of 
space between letters (100 - 500; at 0, no space is 


removed between letters). 


Note: Valid only when Justification = 4 
(psLeftJustified); Justification = 5 
(psCenterJustified); Justification = 
6 (psRightJustified);oOr Justification 
= 7 (psFullydustified).See Justification. 
The following values are also required: 
MaximumLetterScaling and 
DesiredLetterScaling. 
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Property 


Value Type 


What it is (Continued) 


MinimumWordScaling 


Note: ‘Word Scaling’ is 
basically equivalent to 
‘Word Spacing’ in the 
Adobe Photoshop CS2 
application Justification 
dialog (Select 
Justification on the 
Paragraphs palette 
menu). 


NoBreak 


Oldstyle 


Parent 


Position 


RightIndent 


Size 


SpaceAfter 


SpaceBefore 


StrikeThru 


TextComposer 


Number (Double) 


Boolean 


Boolean 


Object (ArtLayer) 


Array 
(UnitValue) 


Number (Double) 


Number (Double) 


Number (Double) 


Number (Double) 


PsStrikeThruType 


PsTextComposer 


Read-write. The minimum amount (percentage) of 
space between words (0 -1000; at 100, no space is 
removed between words). 


Note: Valid only when Justification = 4 
(psLeftJustified); Justification = 5 
(psCenterJustified); Justification = 
6 (psRightJustified);oOr Justification 
= 7 (psFullydustified). See Justification. 
The following values are also required: 
MaximumWordScaling and 
DesiredWordScaling. 


Read-write. Indication of whether to allow words to 
break at the end of a line. 


Tip: When enacted on large amounts of 
consecutive characters, noBreak = true can 
prevent word wrap and thus may prevent 
some text from appearing on the screen. 


Read-write. Indication of whether to use old style 
type. 


Read-write. The Text Item object's container. 


Read-write. The position of origin for the text. The 
array must contain two values (unit value). 


Tip: Setting the Position property is basically 
equivalent to clicking the text tool at a point in 
the document to create the point of origin for 
text. 


Read-write. The amount of space (unit value) to 
indent text from the right (-1296 - 1296). 


Read-write. The font size in points. 


Read-write. The amount of space (unit value) to use 
after each paragraph (-1296 - 1296). 


Read-write. The amount of space (unit value) to use 
before each paragraph (-1296 - 1296). 


Read-write. The text strike through option to use. 


Read-write. The composition method to use to 
evaluate line breaks and optimize the specified 
hyphenation and Justification options. 


Note: Valid only when Kind = 2 
(psParagraphText). See Kind. 
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Property 


Value Type 


What it is (Continued) 


Tracking 


typename 


Underline 


UseAutoLeading 


VerticalScale 


WarpBend 


WarpDirection 


WarpHorizontalDistortion 


WarpStyle 


WarpVerticalDistortion 


Number (Double) 


String 


PsUnderlineType 


Boolean 


Number (Long) 


Number (Double) 


PsDirection 


Number (Double) 


PsWarpStyle 


Number (Double) 


Read-write. The amount of uniform spacing 
between multiple characters (-1000 - 10000). 


Note: Tracking units are 1/1000 of an em space. The 
width of an em space is relative to the 
current type size. In a 1-point font, 1 em 
equals 1 point; in a 10-point font, 1 em 
equals 10 points. So, for example, 100 units in 
a 10-point font are equivalent to 1 point. 


Read-only. The class name of the referenced 
Text Item object. 


Read-write. The text underlining options. 


Read-write. Indication of whether to use a font's 
built-in leading information. 


Read-write. Character scaling (vertical) in 
proportion to horizontal scale (0 - 1000 in percent). 
See HorizontalScale. 


Read-write. The warp bend percentage (-100 - 100). 
Read-write. The warp direction. 


Read-write. The horizontal distortion (as 
percentage) of the warp (-100 - 100). 


Read-write. The style of warp to use. 


Read-write. The vertical distortion (as percentage) 
of the warp (-100 - 100). 


Width Number (Double) Read-write. The width of the bounding box (unit 
value) for paragraph text. 
Note: Valid only when Kind = 2 

(psParagraphText). See Kind. 
Method Parameter Type Returns What it does 
ConvertToShape Converts the text item and its containing layer to 
() a fill layer with the text changed to a clipping 
path. 
CreatePath Creates a clipping path from the outlines of the 


() 


actual text items (such as letters or words). 
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Options that can be specified when saving a document in TIFF format. 


Property Value Type What it is 

AlphaChannels Boolean Read-write. Indication of whether to save the 
alpha channels. 

Annotations Boolean Read-write. Indication of whether to save the 
annotations. 

Application Object (Application) Read-only. The application that the collection 
belongs to. 

ByteOrder PsByteOrder Read-write. The order in which the document's 
bytes will be read. The default is 2 
(psMacOSByteOrder) whenrunning on Mac OS 
and 1 (psIBMByteOrder) when running ona PC. 

EmbedColorProfile Boolean Read-write. Indication of whether to embed the 
color profile in the document. 

ImageCompression PsTIFFEncodingType Read-write. The compression type. Default: 1 
(psNoTIFFCompression). 

InterleaveChannels Boolean Read-write. Indication of whether the channels in 
the image will be interleaved. 

JPEGQuality Number (Long) Read-write. The quality of the produced image (0 - 
12), which is inversely proportionate to the 
amount of JPEG compression. 

Note: Valid only when ImageCompression = 3 
(psTiffJPEG). 

LayerCompression PsLayerCompressionType Read-write. The method of compression to use 
when saving layers (as opposed to saving 
composite data). 

Note: Valid only when Layers = true. See 
Layers 

Layers Boolean Read-write. Indication of whether to save the 
layers. 

SaveImagePyramid Boolean Read-write. Indication of whether to preserve 
multiresolution information. Default: false. 

SpotColors Boolean Read-write. Indication of whether to save the spot 


colors. 
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Property Value Type What it is (Continued) 

Transparency Boolean Read-write. Indication of whether to save the 
transparency as an additional alpha channel 
when the file is opened in another application. 

typename String Read-only. The class name of the referenced 


TIFFSaveOptions object. 
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Camera raw image file settings stored in an XMP file in the same folder as the raw file with the same base 


name and an XMP extension. 


Property Value Type What it is 
Application Object Read-only. The application that the collection 
(Application) belongs to 
Parent Object Read-only. The object's container. 
(Document ) 
RawData String Read-only. The raw XML form of file information. 
typename String Read-only. The class name of the referenced 


XMPMetadata object. 


Action Manager 


Adobe Photoshop CS2 actions allow you to save time by automating repetitive tasks. You create and run 
actions in the application interface using the Actions palette. 


You can also manage actions in scripts using a utility called the Action Manager. The Action Manager allows 
you to write scripts that target Adobe Photoshop CS2 functionality that is not otherwise accessible in the 
scripting interface, such as third party plug-ins and filters that are available through the application but 
not in the current scripting reference. 


The only requirement for using the Action Manager is that the task that you want to access from the Action 
Manager is recordable. 


This chapter describes how to use the Action Manager and the scripting interface objects it includes. 


Before you use the Action Manager, you must install the ScriptListener plug-in. ScriptListener records a log 
file that contains code corresponding to the actions you perform in the UI. 


Tip: Because ScriptListener records most of your actions, install ScriptListener only when you are creating 
an Action Manager. Leaving ScriptListener installed continuously will create large log files that occupy 
memory on your hard drive. 


When you perform a task or series of tasks in Adobe Photoshop CS2, ScriptListener creates the file 
C:\ScriptingListenerVB.log 


The ScriptListener plug-in is located inthe ..\Adobe Photoshop CS2\Scripting Guide\Utilities 
folder. 


> To install the ScriptListener: 


1. Select the file ScriptListener.81i and then choose Edit > Copy. 


2. Paste the file copy to the following location: 
..\Adobe Photoshop CS\Plug-Ins\Adobe Photoshop Only\Automate 


3. Open Adobe Photoshop CS2. 


Note: If Adobe Photoshop CS2 is already open, close it and then start it again. 


> To uninstall the ScriptListener: 
1. Close Adobe Photoshop CS2. 


2. Verify that a copy of the file scriptListener.81i still exists in the ..\Adobe Photoshop 
CS2\Scripting Guide\Utilities folder. 
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3. Delete the file scriptListener.81i from the following location: 


..\Adobe Photoshop CS\Plug-Ins\Adobe Photoshop Only\Automate 
4. Delete the log file Script ingListenerVB.1log from your C: drive. 


Note: Even though you remove the ScriptListener from the Automate folder, it may continue to record 
actions. To prevent the ScriptingListenerVB.1log file from becoming too large, delete it each 
time you finish playing a Adobe Photoshop CS2 action. 


The objects ActionDescriptor, ActionList and ActionReference are part of the Action Manager 
functionality. 


The section demonstrates how to create the ScriptingListenerVB.1log log file and use its contents to 
create your script. 


The procedures in this section uses the Action Manager to make the Emboss filter available to the scripting 
interface. (By default, the Emboss filter is available only via the Adobe Photoshop CS2 interface.) 


Note: ScriptListener must be installed in the Automate folder before you begin the following procedure. 
See Installing ScriptListener. 


> To make the Emboss filter scriptable: 


1. Open Adobe Photoshop CS2, then open a document. 

2. Choose Window > Actions, then choose New Action from the Actions palette menu. 
3. Name the action, then click Record. 

4. Choose Filter > Stylize > Emboss. 


5. Using the following settings: 
e Angle: 135 
e Height: 3 
e Amount: 100 
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6. Open c:\ScriptingListenerVB.log 


At the end of the file you will see code similar to the following (although your numbers may be 
different): 


DIM objApp 

SET objApp = CreateObject ("Photoshop.Application") 
REM Use dialog mode 3 for show no dialogs 

DIM dialogMode 

dialogMode = 3 


DIM id9 

id9 = objApp.CharIDToTypeID( "Embs" ) 
DIM desc4 
SET desc4 = CreateObject ( "Photoshop.ActionDescriptor" ) 
DIM id10 


id10 = objApp.CharIDToTypeID( "Angl" ) 
Call desc4.PutInteger( id10, 135 ) 
DIM id11 
id11 = objApp.CharIDToTypeID( "Hght" ) 
Call desc4.PutInteger( id11, 3 ) 
DIM id12 
id12 = objApp.CharIDToTypeID( "Amnt" ) 
Call desc4.PutInteger( id12, 100 ) 

Call objApp.ExecuteAction( id9, desc4, dialogMode ) 


Note: ScriptListener separates logged commands with horizontal lines composed of hyphens (-----...). If 
this is not the first action recorded in the log, you can easily locate the most recent action; it follows 
the final hyphen-line. 


7. Inthe script, identify the values that you used with the filter (135, 3 and 100), then copy the VB code 
from ScriptListenerVB.1og to another file and substitute the filter specification values with variable 
names. 


In the following example, 135 has been replaced with angle; 3 has been replaced with height; 100 has 
been replaced with amount. 


DIM objApp 

SET objApp = CreateObject ("Photoshop.Application") 
REM Use dialog mode 3 for show no dialogs 

DIM dialogMode 

dialogMode = 3 


DIM id9 

id9 = objApp.CharIDToTypeID( "Embs" ) 
DIM desc4 
SET desc4 = CreateObject ( "Photoshop.ActionDescriptor" ) 
DIM id10 


id10 = objApp.CharIDToTypeID( "Angl" ) 
Call desc4.PutInteger( id10, angle) 
DIM id11 
id11 = objApp.CharIDToTypeID( "Hght" ) 
Call desc4.PutInteger( id11, height ) 
DIM id12 
id12 = objApp.CharIDToTypeID( "Amnt" ) 
Call desc4.PutInteger( id12, amount ) 

Call objApp.ExecuteAction( id9, desc4, dialogMode ) 


8. Wrap the code in a VBScript function. In the following example, the function name is emboss. 


Function Emboss( angle, height, amount ) 


{ 


DIM objApp 
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SET objApp = CreateObject ("Photoshop.Application") 

REM Use dialog mode 3 for show no dialogs 

DIM dialogMode 

dialogMode = 3 

DIM id9 

id9 = objApp.CharIDToTypeID( "Embs" ) 
DIM desc4 


SET desc4 = CreateObject ( "Photoshop.ActionDescriptor" ) 


DIM id10 
id10 = objApp.CharIDToTypeID( "Angl" ) 
Call desc4.PutInteger( id10, 135 ) 
DIM id11 
id11 = objApp.CharIDToTypeID( "Hght" ) 
Call desc4.PutInteger( id11, 3 ) 
DIM id12 
id12 = objApp.CharIDToTypeID( "Amnt" ) 
Call desc4.PutInteger( id12, 100 ) 

Call objApp.ExecuteAction( id9, desc4, dialogMode ) 


} 
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9. To use a VBScript to apply the Emboss filter to a document, include the emboss function in the script 


and call the function with the desired parameters. For example, the following example applies the 


Emboss filter with angle 75, height 2, and amount 89. 


‘Open the document in the script 
'Call emboss with desired parameters 
emboss( 75, 2, 89 ); 

'finish the script 


‘include the function in the script file 
Function Emboss(angle, height, amount ) 


{ 
DIM objApp 
SET objApp = CreateObject ("Photoshop.Application") 
REM Use dialog mode 3 for show no dialogs 
DIM dialogMode 
dialogMode = 3 
DIM id9 
id9 = objApp.CharIDToTypeID( "Embs" ) 
DIM desc4 


SET desc4 = CreateObject ( "Photoshop.ActionDescriptor" ) 


DIM id10 
id10 = objApp.CharIDToTypeID( "Angl" ) 
Call desc4.PutInteger( id10, 135 ) 
DIM id11 
id11 = objApp.CharIDToTypeID( "Hght" ) 
Call desc4.PutInteger( id11, 3 ) 
DIM id12 
id12 = objApp.CharIDToTypeID( "Amnt" ) 
Call desc4.PutInteger( id12, 100 ) 

Call objApp.ExecuteAction( id9, desc4, dialogMode ) 


} 


You can also access JavaScript-based Action Manager code from a VBScript using the DoJavaScriptFile 
command. See ‘DoJavaScriptFile’ on page 18 for more information. 
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> To execute JavaScript-based Action Manager code from a VBScript: 


1. Save the following script in a file called “C:\Emboss.jsx” 


function emboss( angle, height, amount ) 


{ 


} 


var id32 = charIDToTypeID( "Embs" ); 
var desc7 = new ActionDescriptor() ; 
var id33 = charIDToTypeID( "Angl" ); 
desc7.putInteger( id33, angle ); 
var id34 = charIDToTypeID( "Hght" ); 
desc7.putInteger( id34, height ); 
var id35 = charIDToTypeID( "Amnt" ); 
desc7.putInteger( id35, amount ); 
executeAction( id32, desc7 ); 


// Call emboss with values provided in the "arguments" collection 
emboss( arguments[0], arguments[1], arguments[2] ); 


2. From VBScript you can then run the Emboss filter by saying: 


Set objApp = CreateObject ("Photoshop.Application") 
objApp.DoJavaScriptFile "C:\Emboss.jsx", Array(75, 2, 89) 
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4 Scripting Constants 


This section lists and describes the enumerations defined for use with Adobe Photoshop CS2 VBScript 


properties and methods. 


Constant type 


Values 


What it means 


PsAdjustmentReference 


PsAnchorPosition 


PsAntiAlias 


PsAutoKernType 


PsBatchDestinationType 


PsBitmapConversionType 


PsBitmapHalfToneType 


PsBitsPerChannelType 


1 


(psRelative) 


2 (psAbsolute) 


OUP WNH oMAI HAUT FWNEHE 


NDR 


16 
32 


psTopLeft) 
psTopCenter) 
psTopRight ) 
psMiddleLeft) 
psMiddleCenter) 
psMiddleRight) 
psBottomLeft ) 
psBottomCenter) 
psBottomRight ) 


psNoAntialias) 
psSharp) 
psCrisp) 
psStrong) 
psSmooth) 


psManual1) 
psMetrics) 
psOptical) 


psNoDestination) 
psSaveAndClose) 
psFolder) 


psHalfThreshold) 
psPatternDither) 


psDiffusionDither) 


psHalftoneScreen) 
psCustomPattern) 


1ftoneRound) 


psHalftoneDiamond) 
1ftoneEllipse) 


psHalftoneLine) 
1ftoneSquare) 
psHalftoneCross) 


psDocument1Bit) 
psDocument 8Bits) 


(psDocument16Bits) 
(psDocument32Bits) 


Method to use for interpreting selective 
color adjustment specifications: 1 = % 
of the existing color amount; 2 = % of 
the whole. 


The point on the object that does not 
move when the object is rotated or 
resized. 


Method to use to smooth edges by 
softening the color transition between 
edge pixels and background pixels. 


The type of kerning to use for 
characters. 


The destination, if any, for 
batch-processed files: 

1: Leave all files open; 

2: Save changes and close the files; 

3: Save modified versions of the files to 
a new location (leaving the originals 
unchanged). 


Specifies the quality of an image you 
are converting to bitmap mode. 


Specifies the shape of the dots (ink 
deposits) in the halftone screen. 


The number of bits per color channel. 
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Constant type 


Values 


What it means 


PsBlendMode 


PsBMPDepthType 


PsByteOrder 


PsCameraRAWSettingsType 


PsCameraRAWSize 


PsCase 


DANI HHRAUAPWDNH 


16 
17 
18 
19 
20 
21 
22 
23 


psPassThrough) 
psNormalBlend) 
psDissolve) 
psDarken) 
psMultiply) 
psColorBurn) 
psLinearBurn) 
psLighten) 
psScreen) 
(psColorDodge) 
(psLinearDodge) 
(psOverlay) 
(psSoftLight ) 
(psHardLight ) 
(psVividLight) 
(psLinearLight ) 
(psPinLight) 
( 
( 
( 
( 
( 
( 


psDifference) 


psColorBlend) 
psLuminosity) 


1 (psBMP1Bit) 
4 (psBMP4Bits) 
8 (psBMP8Bits) 


16 
24 
32 
60 
61 
62 
63 
64 
65 
66 
67 


1 
2 


OUP WNEH OO 


(psBMP16Bits) 
(psBMP24Bits) 
(pSsBMP32Bits) 
(PSBMP_X1R5G5B5) 
(PSBMP_A1R5G5B5) 
(PSBMP_R5G6B5) 

( » X4R4G4B4 ) 
(  A4R4G4B4) 
(  R8G8B8) 

(  X8R8G8B8) 
(  A8R8G8B8) 


psIBMByteOrder) 
psMac OSByteOrder) 


psCameraDefault) 
psSelectedImage) 
psCustomSettings) 


psMinimumCameraRAW) 
psSmallCameraRAW) 
psMediumCameraRAWw) 
psLargeCameraRAW) 


psExtraLargeCameraRAW) 


psMaximumCameraRAW) 


psNormalCase) 
psAllCaps) 
psSmallCaps) 


Controls how pixels in the image are 
blended. 


The number of bits per channel (also 
called pixel depth or color depth). The 
number selected indicates the 
exponent of 2. For example, a pixel with 
a bit-depth of s has 28, or 256, possible 
color values. 


The order in which bytes will be read. 


The default CameraRaw settings to use: 
the camera settings, custom settings, or 
the settings of the selected image. 


The camera RAW size type options: 
o = 1536 x 1024 
1 =2048 x 1024 
2 =3072 x 1024 
4 =4096 x 1024 
5 =5120x 1024 


The case usage for type. 
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Constant type 


Values 


What it means 


PsChangeMode 


PsChannelType 


PsColorBlendMode 


PsColorModel 


PsColorPicker 


PsColorProfileType 


NHN UPWNH 


AWN 


psConvertToGrayscale) 
psConvertToRGB) 
psConvert ToCMYK) 
psConvertToLab) 
psConvertToBitmap) 


psConvertToIndexedColor) 
psConvertToMultiChannel) 


psComponentChannel) 


psMaskedAreaAlphaChannel ) 
psSelectedAreaAlphaChannel) 


psSpotColorChannel) 


psNormalBlendColor) 

psDissolveBlend) 

psDarkenBlend) 

psMultiplyBlend) 

psColorBurnBlend) 

psLinearBurnBlend) 

psLightenBlend) 

psScreenBlend) 
(psColorDodgeBlend) 
(psLinearDodgeBlend) 
(psOverlayBlend) 
(psSoftLightBlend) 
(psHardLightBlend) 
(psVividLightBlend) 
(psLinearLightBlend) 
(psPinLightBlend) 
(psDifferenceBlend) 
(psExclusionBlend) 
(psHueBlend) 

( 

( 

( 

( 

( 


psSaturationBlendColor 


psColorBlendMode) 
psLuminosityBlend 
psBehindBlend) 
psClearBlend) 


psGrayscaleModel1) 
PSRGBModel ) 
pSCMYKModel1 ) 
psLabModel1) 
PSHSBModel1 ) 
(psNoModel ) 


psAdobeColorPicker) 
psAppleColorPicker) 
psWindowsColorPicker) 
psPlugInColorPicker) 


psNo) 
psWorking) 
psCustom) 


The type of color mode to use. 


Note: Color images must be changed 
to grayscale (1) mode before 
you can change them to bitmap 
(5) mode. 


The type of channel: 

1: related to document color mode; 2: 
Alpha channel where color indicates 
masked area; 3: Alpha channel where 
color indicates selected area; 4: channel 
that contains spot colors. 


Controls how pixels in the image are 
blended. 


The color model to use. 


The color picker to use. 


The color profile type to use to manage 
this document. 
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Constant type 


Values 


What it means 


PsColorReductionType 


PsColorSpaceType 


PsCopyrightedType 


PsCreateFields 


PsCropToType 


PsDCSType 


PsDepthMapSource 


PsDescValueType 


PsDialogModes 


PsDirection 


ONINAHnADAUHPFWNEFO 


WNRO 


BR 


BWDHYP 
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psPerceptualReduction) 
psSelective) 
psAdaptive) 
psRestrictive) 
psCustomReduction) 
psBlackWhiteReduction) 
psSFWGrayscale) 
psMacintoshColors) 
psWindowsColors) 


psAdobeRGB) 
psColorMat chRGB) 
psProPhotoRGB) 
psSRGB) 


psCopyrightedwWork) 
psPublicDomain) 
psUnmarked) 


psDuplication) 
psiInterpolation) 


psBoundingBox) 
psMediaBox) 
psCropBox) 
psBleedBox) 
psTrimBox) 
psArtBox) 


psNoComposite) 
psGrayscaleComposite) 
psColorComposite) 


psNoSource) 
psTransparencyChannel) 
psLayerMask) 
psImageHighlight) 


psIntegerType) 
psDoubleType 
psUnitDoubleType) 
psStringType 
psBooleanType) 
psListType) 

psObjectType 
psEnumeratedType) 
psReferenceType) 

(psClassType 
(psAliasType 
(psSmartObject ) 


(psDisplayAl1Dialogs) 
(psDisplayErrorDialogs) 
(psDisplayNoDialogs) 


(psHorizontal) 
(psVertical) 


The color reduction algorithm option 
to use. 


The type of color space to use. 


The copyright status of the document. 


The method to use for creating fields. 


The style to use when cropping a page. 


The DCS format to use: 


1: Does not create a composite file; 2: 
Creates a grayscale composite file in 
addition to DCS files; 3: Creates a color 
composite file in addition to DCS files. 


What to use for the depth map. 


The value type of an object. 


Controls the type (mode) of dialogs 
Photoshop displays when running 
scripts. 


The orientation of the object. 
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Constant type Values What it means 
PsDisplacementMapType 1 (psStretchToFit) Describes how the displacement map 
2 (psTile) fits the image if the image is not the 
same size as the map. 
PsDitherType 1 (psNoDither) The default type of dithering to use. 

2 (psDiffusion) 

3 (psPattern) 

4 (psNoise) 

PsDocumentFill 1 (psWhite) The fill of the document. 

2 (psBackgroundColor) 

3 (psTransparent) 

PsDocumentMode 1 (psGrayscale) The color mode of the open document. 

2 (psRGB) 

3 (psCMYK) 

4 (psLab) 

5 (psBitmap) 

6 (psIndexedColor) 

7 (psMultiChannel) 

8 (psDuotone) 

PsEditLogItemsType 1 (psSessionOnly) The history log edit options: 
2 (psConcise) 1: Save history log only for the session; 
3 (psDetailed) .: 3 
2: Save a concise history log; 3: Save a 
detailed history log. 
PsElementPlacement 0 (psPlaceInside) The object’s position in the Layers 

1 (psPlaceAtBeginning) palette. 

2 (psPlaceAtEnd) 

3 (psPlaceBefore) i ; 

4 (psPlaceafter) Note: Not all values are valid for all 
object types. Please refer to the 
object property definition in 
VBScript Interface to make sure 
you are using a valid value. 

PsEliminateFields 1 (psOddFields) The type of fields to eliminate. 

2 (psEvenFields) 

PsExportType 1 (psIllustratorPaths) The export options to use. 

2 (psSaveForWeb) 

PsExtensionType 2 (psLowercase) The formatting of the extension in the 

3 (psUppercase) filename. 
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Constant type Values What it means 
PsFileNamingType 1 (psDocumentNameMixed) File naming options for the batch 
2 (psDocumentNameLower) command. 
3 (psDocumentNameUpper) 
4 (psSerialNumber1) 
5 (psSerialNumber2) 
6 (psSerialNumber3 ) 
7 (psSerialNumber4) 
8 (psSerialLetterLower) 
9 (psSerialLetterUpper) 
10 (psMmddyy) 
11 (psMmdd) 
12 (psYyyymmdd) 
13 (psYymmdd) 
14 (psYyddmm) 
15 (psDdmmyy) 
16 (psDdmm) 
17 (psExtensionLower) 
18 (psExtensionUpper) 
psFontPreviewType 0 (psFontPreviewNone) The type size to use for font previews in 
1 (psFont PreviewSmal1) the type tool font menus. 
2 (psFontPreviewMedium) 
3 (psFontPreviewLarge) 
PsForcedColors 1 (psNoForced) The type of colors to be forced 
: Peay (included) into the color table: 
psPrimaries . ere 
4 (psWeb) 2: Pure black and pure white; 3: Red, 
green, blue, cyan, magenta, yellow, 
black, and white; 4: the 216 web-safe 
colors. 
PsFormatOptionsType 1 (psStandardBaseline) The option with which to save a JPEG 
B Oinee aaa. file: 1: Format recognized by most web 
ia eae browsers; 2: Optimized color and a 
slightly reduced file size; 3: Displays a 
series of increasingly detailed scans as 
the image downloads. 
PsGalleryConstrainType 1 (psConstrainWidth) The type of proportions to constrain for 
2 (psConstrainHeight) images. 
3 (psConstrainBoth) 
PsGalleryFontType 1 (psArial) The fonts to use for the Web photo 
2 (psCourierNew) gallery captions and other text. 
3 (psHelvetica) 
4 (psTimesNewRoman) 
PsGallerySecurityTextPositionType 1 (psParagraphText) The position of the text displayed over 
2 (psUpperLeft) gallery images as an antitheft 
3 (psLowerLeft) det t 
4 (psUpperRight ) Ererrent 
5 (psLowerRight) 
PsGallerySecurityTextRotateType 1 (psZero) The orientation of the text displayed 
2 (psClockwise45) over gallery images as an antitheft 
3 (psClockwise90) det t 
4 (psCounterClockwise45) eterren 
5 (psCounterClockwise90) 
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Constant type Values What it means 
PsGallerySecurityType 1 (psNoSecurity) The content to use for text displayed 
2 (psCustomSecurityText) over gallery images as an antitheft 
3 (psFilename) det t 
4 (psCopyright) Sues 
5 (psCaption) . 
6 (psCredit) Note: All types draw from the image's 
7 (psTitle) file information except 2. 
PsGalleryThumbSizeType 1 (psSmall) The size of thumbnail images in the 
2 (psMedium) web photo gallery. 
3 (psLarge) 
4 (psCustomThumbnail) 
PsGeometry 0 (psTriangle) Geometric options for shapes, such as 
1 (psPentagon) the iris shape in the Lens Blur Filter. 
2 (psHexagon) 
3 (psSquareGeometry) 
4 (psHeptagon) 
5 (psOctagon) 
PsGridLineStyle 1 (psGridSolidLine) The line style for the nonprinting grid 
2 (psGridDashedLine) displayed over images. 
3 (psGridDottedLine) 
PsGridSize 1 (psNoGrid) The value of grid line spacing. 
2 (psSmallGrid) 
3 (psMediumGrid) 
4 (psLargeGrid) 
PsGuideLineStyle 1 (psGuideSolidLine) The line style for nonprinting guides 
2 (psGuideDashedhine) displayed over images. 
PsIllustratorPathType 1 (psDocumentBounds) The paths to export. 
2 (psAllPaths) 
3 (psNamedPath) 
PsIntent 1 (psPerceptual) The rendering intent to use when 
2 (psSaturation) converting from one color space to 
3 (psRelativeColorimetric) th 
4 (psAbsoluteColorimetric) another. 
PsJavaScriptExecutionMode 1 (psNeverShowDebugger) The debugging behavior to use when 
2 (psDebuggerOnError) executing a JavaScript. 
3 (psBeforeRunning) 
PsJustification 1 (psLeft) The placement of paragraph text within 
2 (psCenter) the bounding box. 
3 (psRight) 
4 (psLeftJustified) 
5 (psCenterJustified) 
6 (psRightJustified) 
7 (psFullyJustified) 
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Constant type 


Values 


What it means 


PsLanguage 


PsLayerCompressionType 


PsLayerKind 


PsLayerType 


PsLensType 


PsMagnificationType 


PsMatteType 


PsNewDocumentMode 


DANI HHAUOFWN?-E 
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psEnglishUSA) 
psEnglishUK) 
psCanadianFrench) 
psFrench) 
psFinnish) 
psGerman) 
psOldGerman) 
psSwissGerman) 
psItalian) 
(psNorwegian) 
psNynorskNorwegian) 
psPortuguese) 


psBrazillianPortuguese) 


( 

( 

( 
(psSpanish) 
(psSwedish) 

(psDutch) 

(psDanish) 
pSRLELayerCompression) 
psZIPLayerCompression) 


psNormalLayer) 
psTextLayer) 
psSolidFillLayer) 
psGradientFillLayer) 
psPatternfillLayer) 
psLevelsLayer) 
psCurvesLayer) 
psColorBalanceLayer) 


psBrightnessContrastLayer) 


(psHueSaturationLayer) 
(psSelectiveColorLayer) 
(psChannelMixerLayer) 
(psGradientMapLayer) 
(psThresholdLayer) 
(psInversionLayer) 
(psPosterizeLayer) 
(psSmartObjectLayer) 


psArtLayer) 
psLayerSet) 


psZoomLens ) 
psPrime35) 
psPrime105) 
psMoviePrime) 


psActualSize 
psFitPage 


psNoMatte) 
psForegroundColorMatte) 
psBackgroundColorMatte) 
psWhiteMatte) 
psBlackMatte) 
psSemiGray) 
psNetscapeGrayMatte) 


psNewGray) 
psNewRGB) 
psNewCMYK) 
psNewLab) 
psNewBitmap) 


The language to use. 


Compression methods for data for 
pixels in layers. 


The kind of ArtLayer object. 


The kind of layer object. 


The type of lens to use. 


The type of magnification to use when 
viewing an image. 


The color to use for matting. 


The color profile to use for the 
document. 
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Constant type 


Values 


What it means 


PsNoiseDistribution 


PsOffsetUndefinedAreas 


PsOpenDocumentMode 


PsOpenDocumentType 


PsOperatingSystem 


PsOrientation 


PsOtherPaintingCursors 


BR 


psUniformNoise) 
2 (psGaussianNoise) 


1 (psOffsetSetToLayerFill) 
2 (psOffsetWraparound) 
psOffsetRepeatEdgePixels) 


Ww 


psOpenGray) 
psOpenRGB) 
psOpenCMYK) 
psOpenLab) 


AWUN 


psPhotoshopOpen) 
PSBMPOpen) 
psCompuServeGIFOpen) 
psPhotoshopEPSOpen) 
psFilmstripOpen) 
psJPEGOpen) 

psPCXOpen) 
psPhotoshopPDFOpen) 

9 (psPhotoCDOpen) 

10 (psPICTFileFormatOpen) 


OI AHAOKRWNE 


psPixarOpen) 
psPNGOpen) 

psRawOpen) 
psScitexCTOpen) 
psTargaOpen) 
psTIFFOpen) 
psPhotoshopDCS_10pen) 
psPhotoshopDCS_20pen) 


psPDFOpen) 

psEPSOpen) 
pSEPSPICTPreviewOpen) 
pSEPSTIFFPreviewOpen) 
psAliasPIXOpen) 
psElectricImageOpen) 
psPortableBitmapOpen) 
psWavefrontRLAOpen) 
psSGIRGBOpen) 

psSoft ImageOpen) 
psWirelessBitmapOpen) 
psCameraRAWOpen) 


1 (psOS2) 
2 (psWindows) 


1 (psLandscape) 
2 (psPortrait) 


1 (psStandardOother) 
2 (psPreciseOther) 


psPICTResourceFormatOpen) 


psAcrobatTouchUpImageOpen) 


Distribution method to use when 
applying an Add Noise filter. 


Method to use to fill the empty space 
left by offsetting a an image or 
selection. 


The color profile to use. 


The format in which to open a 
document. 


The operating system. 
The page orientation. 


The pointer for the following tools: 
Eraser, Pencil, Paintbrush, Healing 
Brush, Rubber Stamp, Pattern Stamp, 
Smudge, Blur, Sharpen, Dodge, Burn, 
Sponge. 


VBScript Scripting Reference 


Adobe Photoshop CS2 


Scripting Constants 159 


Constant type 


Values 


What it means 


PsPaintingCursors 


PsPaletteType 


PsPathKind 


PsPDFCompatibilityType 


PsPDFEncoding 


PsPDFResampleType 


PsPDFStandardType 


PsPhotoCDColorSpace 


WNP 
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BWDHOP 


(psStandard) 
(psPrecise) 
(psBrushsize) 


psExact) 

psMac OSPalette) 
psWindowsPalette 
psWebPalette) 
psUniform) 

psLocal Perceptual) 
psLocalSelective) 
psLocalAdaptive) 
psMasterPerceptual) 
(psMasterSelective) 
(psMasterAdaptive) 
(psPreviousPalette) 


psNormalPath) 
psClippingPath) 
psWorkPath) 
psVectorMask) 
psTextMask) 


psPDF13 
psPDF14 
psPDF15 
psPDF16 


psPDFNone) 
PSPDFZip) 
PSPDFJPEG) 
PSPDFPDFZip4Bit) 
pSPDFJPEGHIGH) 
pSPDFJPEGMEDHIGH) 
psPDFJPEGMED 
pSPDFJPEGMEDLOW) 
psPDFJPEGLOW 
PSPDFUPEG2000High) 


psNoResample 
psPDFAverage 
psPDFSubSamp1le) 
PSPDFBicubic 


psNoStandard 
psPDFX1A2001 
psPDFX1A2003 
pSPDFX32002) 
pSPDFX32003) 


PSRGB8) 
PSRGB16) 
psLabs) 
psLab16) 


The pointer for the following tools: 
Marquee, Lasso, Polygonal Lasso, Magic 
Wand, Crop, Slice, Patch Eyedropper, 
Pen, Gradient, Line, Paint Bucket, 
Magnetic Lasso, Magnetic Pen, 
Freeform Pen, Measure, Color Sampler. 


The palette type to use. 


The type of path. 


The PDF version to make the document 
compatible with. 


Encoding and compression options to 
use when saving a document in PDF 
format. 


The down sample method to use. 


The PDF standard to make the 
document compatible with. 


The color space to use when creating a 
Photo CD. 
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Constant type 


Values 


What it means 


PsPhotoCDSize 


PsPICTBitsPerPixels 


PsPICTCompression 


PsPicturePackageTextType 


PsPointKind 


PsPointType 


PsPolarConversionType 


PsPreviewType 


PsPrintEncoding 


PsPurgeTarget 


PsQueryStateType 


PsRadialBlurMethod 


PsRadialBlurQuality 


Nu WNP 


WrRorRND 


PWN 


psMinimumPhotoCD) 
psSmallPhotoCD) 
psMediumPhotoCD) 
psLargePhotoCD) 
psExtralargePhotoCD) 
psMaximumPhotoCD) 


psPICTTwoBits) 
psPICTFourBits) 
psPICTEightBits) 
(psPICTSixteenBits) 
(psPICTThirtyTwoBits) 


psNoPICTCompression) 
PpSJPEGLOwPICT) 
pSJPEGMediumPICT) 
PSJPEGHighPICT) 
pPSJPEGMaximumPICT) 


psNoText ) 
psUserText ) 
psFilenameText ) 
psCopyrightText ) 
psCaptionText ) 
psCreditText) 
psOriginText ) 


psSmoothPoint) 
psCornerPoint ) 


psPostScript Points) 
psTraditionalPoints) 


psRectangularToPolar) 
psPolarToRectangular) 


psNoPreview) 
psMonochromeTIFF) 
psEightbitTIFF) 


psBinaryEncoding) 
psJPEGEncoding) 
psAsciiEncoding) 


psUndoCaches) 
psHistoryCaches) 
psClipboardCache) 
psAllCaches) 


psAlways) 
psAsk) 
psNever) 


psSpin) 
psZoom) 


psRadialBlurDraft) 
psRadialBlurGood) 
psRadialBlurBest) 


The pixel dimensions of the image. 


The number of bits per pixel to use 
when compression a PICT file. 


Note: Use 16 or 32 for RGB images; use 
2, 4, or 8 for bitmap and 
grayscale images. 


The type of compression to use when 
saving an image as a PICT file. 


The function or meaning of text ina 
Picture Package. 


The role a PathPoint plays in a 
PathItem. 


The kind of measurement to use for 
type points: 1 = 72 points/inch; 2 = 
72.27 points/inch. 


The method of polar distortion to use. 


The type of image to use asa 
low-resolution preview in the 
destination application. 


The type of encoding to use. 


Cache to be targeted in a purge 
operation. 


Permission state for queries. 


The blur method to use. 


The smoothness or graininess of the 
blurred image. 
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Constant type 


Values 


What it means 


PsRasterizeType 


PsReferenceFormType 


PsResampleMethod 


PsRippleSize 


PsSaveBehavior 


PsSaveDocumentType 


PsSaveEncoding 


Nu WNP 


psTextContents) 
psShape) 
psFillContent) 
psLayerClippingPath) 
psEntireLayer) 
psLinkedLayers) 


psReferenceNameType) 
psReferenceIndexType) 
psReferenceIdentifierType) 
psReferenceOffsetType) 
psReferenceEnumeratedType) 
psReferencePropertyType) 
psReferenceClassType) 


psNoResampling) 
psNearestNeighbor) 
psBilinear) 
psBicubic) 
psBicubicSharper) 
psBicubicSmoother) 


psSmallRipple) 
psMediumRipple) 
psLargeRipple) 


psNeverSave) 
psAlwaysSave) 
psAskWhenSaving) 


psPhotoshopSave) 
PSBMPSave) 
psCompuServeGIFSave) 
psPhotoshopEPSSave) 
psJPEGSave) 

psPCXSave) 
psPhotoshopPDFSave) 
(psPICTFileFormatSave) 
psPICTResourceFormatSave 
psPixarSave) 
psPNGSave ) 

psRawSave ) 
psScitexCTSave) 
psTargaSave) 
psTIFFSave) 
psPhotoshopDCS_1Save) 
psPhotoshopDCS_2Save) 
psAliasPIXSave) 
psElectricImageSave) 
psPortableBitmapSave) 
psWavefrontRLASave) 
psSGIRGBSave) 

psSoft ImageSave) 
psWirelessBitmapSave) 1 


(psBinary) 
(pSTJPEGLow) 
(psAscii) 
(pSsTPEGMedium) 
(psJPEGHigh) 
(psJPEGMaximum) 


The layer element to rasterize. 


The type of an ActionReference object. 


The method to use for image 
interpolation. 


The undulation size to use. 


The application's behavior when a Save 
method is called. 


The format in which to save a 
document. 


The type of encoding to use when 
saving a file. 
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Constant type Values What it means 
PsSaveLogItemsType 1 (psMetadata) The location of history log data. 
2 (psLogFile) 
3 (psLogFileAndMetadata) 
PsSaveOptions 1 (psSaveChanges) The save options to use when the 
: a ' Close method is called to close a 
psPromptToSaveChanges document: 
PsSelectionType 1 (psReplaceSelection) The selection behavior when a 
2 (psExtendSelection) selection already exists: 
3 (psDiminishSelection) : Repl th lected . 
4 (psIntersectSelection) 1: Replace the PSEC ea area; 
2: Add the selection to an already 
selected area; 
3: Remove the selection from the 
already selected area; 
4: Make the selection only the area 
where the new selection intersects the 
already selected area. 
PsShapeOperation 1 (psShapeAdd) AsubPathItem object’s behavior 
2 (psShapeXOR) when it intersects another 
3 (psShapeIntersect) biact 
4 (psShapeSubtract) subPathItem object. 
PsSmartBlurMode 1 (psSmartBlurNorma1) The method to use for smart blurring: 
2 (psSmartBlurEdgeOnly) 1 : Apply blur to entire image; 
3 (psSmartBlurOverlayEdge) 
2, 3 : Apply blur only to edges of color 
transitions. 
PsSmartBlurQuality 1 (psSmartBlurLow) The blur quality to use. 
2 (psSmartBlurMedium) 
3 (psSmartBlurHigh) 
PsSourceSpaceType 1 (psDocumentSpace) 
2 (psProofSpace) 
PsSpherizeMode 1 (psNormalSpherize) The curve (or stretch shape) to use for 
2 (psHorizontalSpherize) the distortion. 
3 (psVerticalSpherize) 
PsStrikeThruType 1 (psStrikeOff) The style of strikethrough to use. 
2 (psStrikeHeight 
3 (psStrikeBox) 
PsStrokeLocation 1 (psInsideStroke The placement of path or selection 


PsTargaBitsPerPixels 


PsTextComposer 


PsTextType 


2 (psCenterStroke 
3 (psOutsideStroke 


16 (psTargalé6Bits 
24 (psTarga24Bits 
32 (psTarga32Bits 


1 (psAdobeSingleLine) 
2 (psAdobeEveryLine) 


1 (psPointText) 
2 (psParagraphText ) 


boundary strokes. 


The resolution to use when saving an 
image in Targa format. 


The composition method to use to 
optimize the specified hyphenation 
and justification options. 


The type of text: 1: Text that does not 
wrap; 2: Text that wraps within a 
bounding box. 
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Constant type 


Values 


What it means 


PsTextureType 


PsTIFFEncodingType 


PsToolType 


PsTransitionType 


PsTrimType 


PsTypeUnits 


PsUndefinedAreas 


psBlocksTexture) 
psCanvasTexture) 
psFrostedTexture) 
psTinyLensTexture) 
psTextureFile) 


OP WNH 


psNoTIFFCompression) 
psTiffLzZw) 
psTiffJPEG) 
psTiffZIP) 


AWUN 


psPencil) 

psBrush) 

psEraser) 
psBackgroundEraser) 
psCloneStamp) 
psPatternStamp) 
psHealingBrush) 
psHistoryBrush) 

9 (psArtHistoryBrush) 
10 (psSmudge) 

psBlur) 
psSharpen) 
psDodge) 

psBurn) 

psSponge) 
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14 


PR 
au 


psBlindsHorizontal) 
psBlindsVertical) 


psBoxIn) 

psBoxOut ) 
psGlitterDown) 
psGlitterRight) 
psGlitterRightDown) 
9 (psNoTransition) 

10 (psRandom) 
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psSplitVerticaliIn) 
psSplitVerticalout) 
psWipeDown) 
psWipeLleft) 
psWipeRight ) 
psWipeUp) 


( 
( 
( 
( 
( 
( 
( 
( 


0 (psTransparent Pixels) 
1 (psTopLeftPixel) 
9 (psBottomRight Pixel 


1 (psTypePixels) 


4 (psTypeMM) 
5 (psTypePoints) 


1 (psWrapAround) 
2 (psRepeatedgePixels) 


psColorReplacementTool1) 


psDissolveTransition) 


psSplitHorizontaliIn) 
psSplitHorizontalOout) 


The type of texture or glass surface 
image to load for a texturizer or glass 
filter. 


The encoding to use for TIFF files. 


The tool selection. 


The method to use to transition from 
one image to the next in a PDF 
presentation. 


Type of pixels to trim around an image: 
9 = bottom right pixel color; 
1 = top left pixel color. 


The unit to use for measuring text 
characters. 


The method to use to treat undistorted 
areas or areas left blank in an image to 

which the a filter in the Distort category 
has been applied. 
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Constant type 


Values 


What it means 


PsUnderlineType 


PsUnits 


PsUrgency 


PsWarpStyle 


PsWaveType 


PsWhiteBalanceType 


PsZigZagType 


1 (psUnderlineOff) 
2 (psUnderlineRight) 
psUnderlineLeft) 


psPixels) 
psiInches) 
psCM) 
psMM) 
psPoints) 
psPicas) 
psPercent ) 
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psNone) 
psLow) 
psTwo) 
psThree) 
psFour) 
psNormal1) 
psSix) 
psSeven) 
psHigh) 
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psNone) 
psArc) 
psArcLower) 
psArcUpper) 
psArch) 
psBulge) 
psShellLower) 
psShellUpper) 
9 (psFlag) 

10 (psWave) 
psFish) 
psRise) 
psFishEye) 
psiInflate) 
psSqueeze) 
psTwist) 
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( 
( 
( 
( 
( 
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1 (psSine) 
2 (psTriangular) 
3 (psSquare) 


psAsShot) 

psAuto) 

psDaylight) 

psCloudy) 

psShade) 

psTungsten) 
psFluorescent ) 

psFlash) 
psCustomCameraSettings) 
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psAroundCenter) 
psOutFromCenter) 
psPondRipples) 


N 


Ww 


The placement of text underlining. 


Note: 3 and 2 are valid only when 
PsDirection = 2. 


The measurement unit for type and 
ruler increments. 


The editorial urgency of the artwork. 


The warp style to use. 


The type of wave to use. 


The lighting conditions to use (affects 
color balance). 


The method of zigzagging to use. 


Appendix A: Event ID Codes 


The following table lists events and their four-character ID codes or string identifiers for use with the 


Notifier object. 


Note: Do not include single quotes ( ' ) with four-character IDs in your code. The single quotes are 
used in this table to illustrate the placement of required spaces in codes that do not contain four 


letters. However, string identifiers, which are longer than four characters, require double quotes in 


the code. 
Event 4-char ID or String 
3DTransform 'TdT ! 
Average 'Avrg' 
ApplyStyle 'ASty' 
Assert 'Asrt' 
AccentedEdges 'AccE' 
Add "Add ! 
AddNoise 'AdNs' 
AddTo 'AddT' 
Align 'Algn' 
All ‘All ' 
AngledStrokes 'AngS' 
ApplyImage 'AppI' 
BasRelief 'BsR1! 
Batch 'Btch' 
BatchFromDroplet 'BtcF' 
Blur 'Blr ' 
BlurMore 'BlrM' 
Border 'Brdr' 
Brightness 'BrgC' 
CanvasSize 'Cnvs! 
ChalkCharcoal "Chic! 
ChannelMixer 'ChnM! 
Charcoal 'Chre! 
Chrome 'Chrm' 
Clear 'Cler' 
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Event 4-char ID or String 
Close 'Cls:! 
Clouds 'Clds' 
ColorBalance 'ClrB! 
ColorHalftone 'ClrH' 
ColorRange 'ClrR! 
ColoredPencil 'ClrP! 
ContactSheet "0B71D221-F8CE-11d2-B21B-0008C75B322C" 
ConteCrayon 'Cntc'! 
Contract 'Cntc! 
ConvertMode 'CnvM' 
Copy 'copy' 
CopyEf fects "CpFX'! 
CopyMerged "CpyM' 
CopyToLayer 'CpTL' 
Craquelure 'Crql! 
CreateDroplet 'CrtD'! 
Crop 'Crop' 
Crosshatch 'Crsh' 
Crystallize 'Crst! 
Curves 'Crvs! 
Custom 'Cstm' 
Cut cut.’ % 
CutToLayer 'CtTL' 
Cutout "Ce: MI 
DarkStrokes 'Drks' 
DeInterlace 'Dntr' 
DefinePattern 'DfnP' 
Defringe 'Dfrg' 
Delete 'Dlt ' 
Desaturate "Dstt! 
Deselect 'Dslc' 
Despeckle 'Dspc' 
DifferenceClouds 'DfrC' 
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Event 4-char ID or String 
Diffuse 'Dfs ' 
DiffuseGlow 'DfsG' 
DisableLayerFX 'dlfx' 
Displace 'Dspl' 
Distribute 'Dstr' 
Draw 'Draw' 
DryBrush 'DryB' 
Duplicate 'Dplc' 
DustAndScratches 'DstsS' 
Emboss 'Embs' 
Equalize 'Eqlz' 
Exchange 'Exch' 
Expand 'Expn' 
Export 'Expr' 
Jumpto 'Jpto' 


ExportTransparent Image 


"02879e00-cb66-11d1-bc43-0060b0a13dc4" 


Extrude 'Extr' 
Facet LECE A 
Fade 'Fade' 
Feather 'Fthr'! 
Fibers 'Fbrs'! 
Fill 'F] '! 
FilmGrain 'FlmG! 
Filter Elitr! 
FindEdges 'FndE' 
FitImage "3caa3434-cb67-11d1-bc43-0060b0a13dc4" 
FlattenImage 'FltI' 
Flip 'Flip' 
Fragment !Frgm' 
Fresco 'Frsc! 
GaussianBlur 'GsnB! 
Get 'getd' 
Glass 'Gls ' 
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Event 4-char ID or String 
GlowingEdges 'GlwE' 
Gradient 'Grdn'! 
GradientMap 'GrMp! 
Grain 'Grn ' 
GraphicPen 'GraP' 
Group 'GrpL' 
Grow 'Grow' 
HalftoneScreen 'H1fS' 
Hide 'Hd =! 
HighPass 'HghP' 
HSBHSL 'HsbP'! 
HueSaturation 'HStr' 
ImageSize ' ImgsS' 
Import ' Impr' 
InkOut lines 'InkO'! 
Intersect 'Intr' 
IntersectWith 'IntW' 
Inverse 'Invs' 
Invert 'Invr' 
LensFlare 'InsF' 
Levels 'Lvls' 
LightingEffects 'LghE' 
Link ‘Ink ! 
Make 'Mk ' 
Maximum 'Mxm ' 
Median 'Mdn ' 
MergeLayers 'Mrg2' 
MergeLayersOld 'MrgL' 
MergeSpotChannel 'MSpt' 
MergeVisible 'MrgV' 
Mezzotint 'Mztn' 
Minimum 'Mnm ' 
ModeChange "8cba8cd6-cb66-11d1l-bc43-0060b0a13dc4" 
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Event 4-char ID or String 
Mosaic 'Msc ! 
Mosaic PLUGIN 'MscT! 
MotionBlur 'MtnB! 
Move 'move' 
NTSCColors 'NTSC' 
NeonGlow 'NGlw' 
Next 'Nxt ' 
NotePaper 'NtPr' 
Notify 'Ntfy' 
Null typeNull 
OceanRipple 'OcnR! 
Offset 'Ofst' 
Open ‘Opn ' 
Paint 'Pnt ! 
PaintDaubs 'PntD! 
PaletteKnife 'PltK' 
Paste 'past' 
PasteEffects 'PaFX' 
PasteInto 'PstI' 
PasteOutside 'PstO! 
Patchwork 'Ptch' 
Photocopy 'Phtc! 
PicturePackage "AC1ABF40-DD82-11d2-B20F-0008C75B322C" 
Pinch 'Pnch'! 
Place "Plc ''! 
Plaster 'Plst' 
PlasticWrap 'Plsw' 
Play 'Ply ' 
Pointillize 'Pntl' 
Polar PAY! 
PosterEdges 'PstE! 
Posterize 'Pstr' 
Previous 'Prvs' 
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Event 4-char ID or String 
Print 'Prnt' 
ProfileToProfile 'PrfT' 
Purge 'Prge' 
Quit "quit! 
RadialBlur "Rd1B' 
Rasterize 'Rstr' 
RasterizeTypeSheet 'RstT! 
RemoveBlackMatte 'RmvB' 
RemoveLayerMask 'RmvL' 
RemoveWhiteMatte "Rmvw'! 
Rename 'Rnm ' 
ReplaceColor '"Rplc! 
Reset 'Rset' 
ResizeImage "1333cf£0c-cb67-11d1-bc43-0060b0a13dc4" 
Reticulation "Rtcl! 
Revert 'Rvrt' 
Ripple 'Rple' 
Rotate 'Rtte' 
RoughPastels 'RghP' 
Save 'save' 
Select telet? 
SelectiveColor 'Slcc! 
Set 'setd' 
SharpenEdges 'ShrE' 
Sharpen 'Shrp' 
SharpenMore 'ShrM' 
Shear 'Shr ! 
Show 'Shw ' 
Similar 'Smlr' 
SmartBlur !' SmrB' 
Smooth 'Smth' 
SmudgeStick 'Smds'! 
Solarize 'Slrz'! 
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Event 4-char ID or String 
Spatter ‘Spt '' 
Spherize 'Sphr'! 
SplitChannels 'Splc! 
Sponge 'Spng' 
SprayedStrokes 'Sprs'! 
StainedGlass 'StnG! 
Stamp 'Stmp' 
Stop 'Stop' 
Stroke 'Strk' 
Subtract 'Sbtr' 
SubtractFrom 'SbtF! 
Sumie 'Smie' 
TakeMergedSnapshot 'TkMr' 
TakeSnapshot 'TkSn' 
TextureFill 'TxtF! 
Texturizer 'Txtz! 
Threshold 'Thrs! 
Tiles Tis! 
TornEdges 'TrnE! 
TraceContour 'TrcC' 
Transform 'Trnf' 
Trap 'Trap' 
Twirl 'Twrl' 
Underpainting 'Undr' 
Undo 'undo' 
Ungroup 'Ungr' 
Unlink 'Unlk' 
UnsharpMask 'UnsM' 
Variations 'Vrtn' 
Wait 'Wait' 
WaterPaper 'WtrP' 
Watercolor 'Wtre' 
Wave 'Wave' 
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Event 


4-char ID or String 


Wind 
ZigZag 
BackLight 
FillFlash 


ColorCast 


'Wnd ' 
'ZgZg' 
'BacL' 
'FilE' 


'ColE' 


Index 


A 
Action Manager 
defined 145 
scripting objects 8-15, 146 
actions 
executing 18 
palette 145 
playback speed 17 
active links 68 
Add Noise filter 24 
adjust 
contrast 27 
AdjustBrightnessContrast 23 
adjusting 
brightness 23 
color balance 23 
colors 150 
component channels 28 
curves 24 
highlights 30 
layers color balance 29 
levels 24,27 
shadows 30 
temperature 29 
Adobe Photoshop CS 2 
activating 17 
new features 5 
version 17 
anchor points 
path point info 101 
path points 100 
anchor position 
types 150 
annotations 53 
anti alias 
text 136 
types 150 
application 
activating 17 
code sample 19 
location 16 
preferences 115 
version 17 
art layers, See layers 
Asian text 117 
Average filter 24 


background color 
application 16 
galleries 68 

background layer 
finding 51 


background layer, designating 22 
Batch command 
destination folder 34 
batch command 
destination types 150 
input folder 17 
beep 115 
bitmap documents 
converting to 36 
opening 158 
saving 37 
bitmap images 
See bitmap documents 36 
BitmapConversionOptions 36 
black and white images 30 
blend modes 151 
Blur filter 24 
blur filters 
Average 24 
Blur 24 
Blur More 24 
Gaussian Blur 25 
Lens Blur 25 
Motion Blur 25 
Radial Blur 26 
Smart Blur 26 
Blur More filter 24 
BMP documents 
opening 158 
saving 37 
brightness 
adjusting 23 
camera shots 38 


equalizing 28 
C 
caches 
histograms 116 
images 116 
purging 18 


camera raw documents 
opening 38, 158 
canvases 
resizing 54 
rotating 53 
captions 
contact sheets 48 
galleries 69 
channels 
activating 51 
adding 41 
alpha See alpha channels 
code sample 41 
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component See component channels 23 
composite See composite channels 
deleting 40 
displaying in color 115 
making visible 40 
merging (spot) 40 
mixing 28 
splitting 55 
spot See spot channels 
types of 152 
clipping paths 
creating 95 
from text 141 
Clouds filter 24 
CMYK color 47 
color picker 115, 152 
colors 
adjusting 23 
blend modes 151 
CMYK 47 
comparing 129 
forced 75, 155 
gray 76 
HSB 79 
Lab 82 
links 68 
none 91 
RGB 122 
selective 29 
solid color objects 129 
component channels 
color balance adjustments 23 
defined 40 
displaying in color 115 
enabling 86 
listing 51 
merging with spot channels 40 
mixing 28 
Compuserve GIF documents 
opening 158 
saving 75 
contact sheets 
captions 48 
dimensions 48 
formatting 48 
making 18 
contrast 
adjusting 23 
adjusting automatically 27 
copyrights 58, 153 
cursors 116 
curves 
adjusting 24 
defining 26 
Custom filter 24 


D 


DCS1 documents 
opening 158 
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Index 


saving 49 
DCS2 documents 
opening 158 
saving 50 
default units 117 
De-Interlace filter 24 
Despeckle filter 24 
dialogs 
displaying 16 
in playback mode 16 
modes 153 
Difference Clouds filter 24 
Diffuse Glow filter 24 
Displace filter 25 
distort filters 
Diffuse Glow 24 
Displace 25 
Glass Effect 25 
Ocean Ripple 26 
Pinch 26 
Polar Coordinates 26 
Ripple 26 
Shear 26 
Spherize 26 
Twirl 27 
Wave 27 
Zigzag 27 
documents 
activating 16 
adding 61 
closing 53 
colors 51 
creating 61 
cropping 53 
exporting 53 
loading 18 
managed 52 
metadata 52,58 
opening 18 
printing 54 
sample code 55 
saving 54 
size 51 
specifying author 58 
title 59 
trapping (CMYK) 55 
trimming 55 
DSC1documents 
saving 161 
Dust & Scratches filter 25 


edit log 115 
EPS documents 

opening 62, 158 

saving 63 
equalizing, brightness values 28 
events, associating with actions 94 
EXIF 58 
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exporting 
documents 53 
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opening 103, 158 
saving 104 
PDF presentations 
auto advance 119 
code sample 21 
making 18 
transition type 163 
transition types 119 
photo galleries 
See galleries 
Photo Merge 18 
PhotoCD documents, opening 107, 158 
Photoshop CS 2, See Adobe Photoshop CS 2 
Photoshop documents 
opening 158 


176 


Adobe Photoshop CS2 


Index 


177 


VBScript Scripting Reference 


saving 108 
Photoshop PDF documents, opening 158 
PICT files 
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selections 
clearing 123 
creating paths from 124 
filling 123 
from paths 96 
inverting 124 
resizing 124 
sample code 125 
selective color 29 
SGIRGB documents 
opening 158 
saving 128, 150 
shadows 23, 30 
Sharpen Edges filter 26 
Sharpen filter 26 
sharpen filters 
Sharpen 26 
Sharpen Edges 26 
Sharpen More 26 
Unsharp Mask 27 
Sharpen More filter 26 
Shear filter 26 
Smart Blur filter 26 
smart quotes 117 
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